Home

und LU6.2-Anwendungen - Fujitsu manual server

1. CICS System 1 LU 4B AE 2A UTM Anwen mit LU 1 openUTM LU62 Instanz 2 dung 4 mit AE 4 LU 4C AE 3A CICS System 2 openUTM LU62 Instanz 3 mit LU2 LU 5A AE 1B openUTM LU62 Instanz 4 CICS System 3 LU 5B AE 2B UTM Anwen mit LU 3 openUTM LU62 Instanz 5 dung 5 mit AE 5 LU 5C AE 3B openUTM LU62 Instanz 6 Kopplung mehrerer Anwendungen mit mehreren Instanzen von openUTM LU62 Jede UTM Anwendung benuizt eine Application Entity AE als Zugriffspunkt zur OSI TP Kommunikation In der UTM Generierung wird dieser Zugriffspunkt als Access Point bezeichnet Die 3 CICS Systeme benutzen je eine Logical Unit LU als Zugriffspunkt zur LU6 2 Kommunikation openUTM LU62 benutzt Application Entities als Zugriffspunkte zur OSI TP Kommunikation und LUs als Zugriffspunkte zur LU6 2 Kommunikation In einer open UTM LU62 Instanz ist jeweils genau eine Application Entity und genau eine LU realisiert Die Instanz 1 von openUTM LU62 realisiert die Verbindung LU 1 AE 4 Die Instanz 2 von openUTM LU62 realisiert die Verbindung LU 2 AE 4 36 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 Konzepte und Funktionen von openUTM LU62 3 1 2 Will also z B die UTM Anwendung 4 eine Verbindung zum CICS System 1 aufbauen so muss sie statt dessen eine Verbindung zur AE 1A aufbauen Will das CICS System 3 eine Verbindung zur UTM Anwendung 5 aufbaue
2. NORMAL SEND Daten Daten Prepare gt RECEIVE STATECSYNCFREE SYNCPOINT RequestCommit Committed gt Forget NORMAL RETURN Wenn beim zweiten Prepare keine Daten gesendet werden k nnen analog zu den Beispie len 12 und 13 die folgenden UTM Aufrufe entfallen MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P 136 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 16 Zwei Transaktionen in einem Vorgang zweite Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A KCLM 0 CTRL PR KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST P MPUT NE Client PEND RE INIT MGET Client MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP lt lt lt FMH5 Daten gt RECEIVE STATE SEND SEND Daten Prepare gt gt RECEIVE STATE SYNCRECEIVE SYNCPOINT RequestCommit Committed gt Forget NORMAL Daten Prepare gt lt RequestCommit RECEIVE STATECSYNCFREE SYNCPOINT Fortsetzung n chste Seite U5461 J Z135 6 137 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 Fortsetzung INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client
3. Insert XPERR Meldungen von openUTM LU62 XPERR Bedeutung 223 Presentation call invalid number of abstract syntaxes ACSE call missing result source 224 Presentation call same abstract syntax occurred already in transparent or non trans parent mode ACSE call invalid result source 225 Presentation call invalid data separation parameter ACSE call invalid diagnostic 226 ACSE call missing reason 227 ACSE call invalid reason 228 ACSE call missing provider reason 229 ACSE call invalid provider reason 230 ACSE call missing abort source 231 ACSE call invalid p requirements 232 ACSE call invalid s requirements 233 ACSE call invalid syntax identifier 234 ACSE call invalid p context identifier 235 ACSE call invalid p context definition list 236 ACSE call invalid p context definition result list 237 ACSE call invalid result in p context definition result list 238 ACSE call invalid default p context result 239 ACSE call invalid default p context name 240 ACSE call invalid user data length 241 ACSE call invalid quality of service 242 ACSE call invalid sync point serial number 243 ACSE call invalid tokens 244 ACSE call invalid SS user reference 245 ACSE call invalid SS common reference 246 ACSE call invalid SS additional reference 250 Presentation call ASN encoding error ACSE call ASN encoding error 251 Presentation call ASN decoding error ACSE call ASN decoding error 252 Presentation call
4. Parameter CICS Host openUTM LU62 openUTM UNIX System Endsystem LU Name DESNIO00 A9CICST6 DESNIO00 T02CGEI4 LU Alias Name CICST6 TO2CGEI4 CP Name DESNIO00 M88 DESNIO00 PO2CGE IDBLK IDNUM 017 2000E MAC Adresse 400037450001 40002222000E MODE Name MODDIS89 IP Adresse 123 45 67 90 123 45 67 89 T Selektor SMP22804 SMP22800 Port Nummer 22804 22800 AP Title 1 2 3 1 2 4 AE Qualifier 1 1 APPL Context UDTSEC Erl uterung im Detail 1 Wenn ein CICS Programm eine UTM Anwendung adressieren will so muss es beim Kommando EXEC CICS ALLOCATE im Parameter SYSID den in CICS defi nierten Connection Namen verwenden Au erdem muss in CICS eine Session de finiert sein die auf diese Connection verweist 2 Zum zweiten muss das CICS Programm beim Kommando EXEC CICS CONNECT PROCESS im Parameter PROCNAME den Transaktionscode des UTM Anwen dungsprogramms angeben 3 Der bei CICS generierte APPLID Name ist der LU Name von CICS Er muss zu sammen mit der in VTAM generierten Netzidentifikation in der TRANSIT Generie rung bei XRLU bzw in der Generierung von SNAP IX oder des IBM Communicati ons Server bei der Definition der Partner LU angegeben werden 102 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren 4 Der LU Name der Stellvertreter LU muss bei VTAM im LU Makro bei CICS in der Connection Definition und bei TRANSIT in der XLU Anweisung bzw bei SNAP IX oder beim
5. 270 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp REASON Grp Ursache MFRMO9 bis M Der Returncode von PutElement war ungleich DM_OK MFRM19 MFRM21 MFRM25 A Kein freier Tabelleneintrag f r einen Log Damage Record vorhanden Ma nahme Log Damage Records mit TP_UPDATE_LOG_DAMAGE_REQ l schen oder nMaxLogDamRec auf einen gr eren Wert setzen MFT102 M Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFT104 M Der Returncode von ChangeDescriptor war ungleich DM_OK MFT105 M Der Returncode von PutElement war ungleich DM_OK MFT106 M Der Returncode von CopyElement war ungleich DM_OK MFT107 M Der Returncode von CopyElement war ungleich DM_OK MFT108 M Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFT109 M Der Returncode von CopyElement war ungleich DM_OK MFT110 M Der Returncode von PutElement war ungleich DM_OK MFT111 MFT112 M Ungiltige Aktionsnummer LOGREMOVE MFT113 M Der Returncode von ChangeDescriptor war ungleich DM_OK MFT114 M Der Returncode von CopyElement war ungleich DM_OK MFT115 M Der Returncode von ChangeDescriptor war ungleich DM_OK MFT119 M Der Returncode von GetLogRecord war ungleich MACF_OK MFT120 bis M Der Returncode von PutElement war ungleich DM_OK MFT127 MFT128 M Der Returncode von CopyElement war ungleich DM_OK MFT129 M
6. CM_OK INIT FGET PEND FI openUTM sendet die Quittungsnachricht sofort nachdem es den Asynchron Auftrag erhal ten und gesichert hat Je nach Verf gbarkeit von Systemressourcen kann es bis zur Aus f hrung des Asynchronauftrags einige Zeit dauern Zu den Vorteilen der Transaktionssicherung bei Asynchron Vorg ngen siehe Seite 132 U5461 J Z135 6 161 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 Start eines CPI C Dialogvorgangs aus einem UTM Anwendungsprogramm 12 Einschrittvorgang mit Transaktionssicherung erste Variante gt lt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE Client PEND FI UTM Systemcode FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED CMSEND Daten Prepare gt gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT RequestCommit Committed gt Forget RR_OK 162 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 13 Einschrittvorgang mit Transaktionssicherung zweite Variante gt INIT MGET APRO MPUT PEND Client DM KCPI gt A KCOF C NE KCRN gt A KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A KCLM 0 CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P MPUT NE
7. time REM LISTENER PORT rem_port REM TSEL ETUA REM NSEL C RE E rem_tsel re ER aa WAREN rem_host AE rem_tns_name REM APT rem_ap_title REM AEQ C APPL CONTEXT C ASSOCIATIONS rem_ae_qualifier UDTCCR UDTSEC UDTAC UDTDISAC J ass_number C CONNECT conn_number J CONTWIN C OSITP CODE ASCII UTM ASYNC YES NO J cwin_number EBCDIC BS2 NO Befinden sich mehrere INSTANCE Anweisungen in der Generierungsdatei so darf das Tri pel REM APT REM AEQ REM LU ALIAS nur in einer INSTANCE Anweisung vorkommen 44 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren Die Parameter haben folgende Bedeutung ALLOC TIME alloc_time Zeit in Sekunden die maximal verstreichen darf wenn beim Starten eines LU6 2 Auftrags also z B eines CICS Transaktionscodes von openUTM aus auf einen Verbindungsaufbau zur LU6 2 Anwendung gewartet werden muss oder wenn beim Starten eines UTM Transaktionscodes von der LU6 2 Anwendung aus auf einen Verbindungsaufbau zu openUTM gewartet werden muss Standardwert 30 Sekunden M gliche Werte 0 300 Sekunden Der Wert 0 bedeutet keine Zeit berwachung APPL CONTEXT UDTCCR UDTSEC UDTAC UDTDISAC Name des Application Context der f r die Verbindung zur UTM Anwendung benutzt wird Der Wert muss dem Wert des APPLICATION CONTEXT Operanden aus der
8. 43 REMOTE_AET_2_BIG Der Application Entity Title des Partners ist l nger als von openUTM unterst tzt 44 REMOTE_AET_CHANGED Beim Aufbau von parallelen Associationen zu einem Partner wird vom Partner nicht derselbe Application Entity Title wie f r die erste aufgebaute Association zu diesem Partner geliefert 45 NO_SPACE_FOR_REMOTE_AET Der PutElement Aufruf zum Abspeichern des Application Entity Title des Partners lie fert einen schlechten Returnwert 46 PARTNER_HAS_STATUS_OFF Der Aufbau der Association wird abgelehnt weil der Partner in der lokalen UTM An wendung gesperrt ist es ist STATUS OFF gesetzt 47 ADDRESS_PRES_ERROR Die bei der Association Indication oder Confirmation mitgelieferte Adresse konnte nicht ausgewertet werden 340 U5461 J Z135 6 Meldungen von open UTM LU62 Insert XPNDIA XPNDIA Bedeutung NO_REASON_GIVEN NO_COMMON_ACSE_VERSION Der Partner lehnt den Associationsaufbauwunsch ab weil es keine gemeinsame ACSE Version gibt APPL_CONTXT_NAM_NOT_SUPPORTD Der Partner lehnt den Associationsaufbauwunsch ab weil er den Application Context Name nicht unterst tzt CALLING_NSEL_NOT_RECON Der Partner lehnt den Association Aufbauwunsch ab weil beim Partner der Absender nicht richtig generiert ist z B falscher N SEL oder nur bei heterogener Kopplung CALLING_AP_TITLE_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab w
9. Daten Prepare gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT lt RequestCommit INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI Committed gt gt IEORgeL Je lt hnlich wie in den Beispielen 12 und 13 k nnen einige UTM Aufrufe entfallen wenn man im Teilprogramm auf die Rollback Commit Information von CPI C verzichtet Der 2 und 3 Programmabschnitt reduziert sich dann auf die Folge INIT MGET NT KCRN gt A VGST 0 TAST 0 CTRL PR KCRN gt A MPUT NE Client PEND RE U5461 J Z135 6 167 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 17 CPI C Anwendungsprogramm setzt Transaktion zur ck und bricht Vorgang ab erste Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED SRRBACK CMSDT CM_DEALLOCATE_ABEND CMDEAL lt FMH7 FMH7 Response gt R cksetzen der Transaktion evtl mit Meldung K034 auf Client Falls zuvor schon ein Sicherungspunkt erreicht war dann Start des Folgeprogramms zu diesem Sicherungspunkt INIT KCKNZVG R MGET NT KCRN gt A VGST 0 TAST R 168 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 18 CPI C Anwendungsprogramm setzt Transaktion zur ck und bricht Vorgang ab zweite Variante gt
10. XPNDIA Bedeutung 13 TRANSIENT_FAILURE Der Partner baut die Association ab weil ein vor bergehender Fehler aufgetreten ist 14 PROTOCOL_ERROR Der Partner baut die Association ab weil ein Protokollfehler aufgetreten ist 15 UNRECOGNIZED_PDU Die Association wird von au en mit P ABORT abgebaut weil die Presentation Schicht eine unbekannte Presentation PDU erhalten hat 16 UNEXPECTED_PDU Die Association wird von au en mit P ABORT abgebaut weil die Presentation Schicht eine unerwartete Presentation PDU erhalten hat 17 UNEXPECTED_SESSION_SERVICE_PRIMITIVE Die Association wird von au en mit P ABORT abgebaut weil die Session Schicht eine unerwartete Session Service Primitive erhalten hat 18 UNRECOGNIZED_PDU_PARAMETER Die Association wird von au en mit P ABORT abgebaut weil die Presentation Schicht einen unbekannten PPDU Parameter erhalten hat 19 UNEXPECTED_PPDU_PARAMETER Die Association wird von au en mit P ABORT abgebaut weil die Presentation Schicht einen unerwarteten PPDU Parameter erhalten hat 20 INVALID_PPDU_PARAMETER_VALUE Die Association wird von au en mit P ABORT abgebaut weil die Presentation Schicht einen ung ltigen PPDU Parameterwert erhalten hat 21 RELEASE_NORMAL Die Association wird vom Partner mit release abgebaut Der Partner gibt als Grund release normal an 22 RELEASE_URGENT Die Association wird vom Partner mit release abgebaut Der
11. openUTM LU62 Generierung bei Verwendung von TNSX INSTANCE LOC LU ALIAS LOC AE LOC APT LOC AEQ REM LU ALTAS MODENAME U62 CODE EM AE EM APT EM AEQ PPL CONTEXT SSOCIATIONS CONNECT CONTWIN OSITP CODE TO2CGEIA SMP22804 61 525395 ae CICST6 MODDIS89 EBCDIC 273 SMP22800 utmlu62 152 4 1 UDTSEC 15 4 Sg ASCII 19 36 37 22 23 20 5 29 30 33 25 26 27 6 28 19 21 22 23 20 5 24 25 26 27 6 28 U5461 J Z135 6 89 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 TNSX Generierung SMP22800 utm1u62 24 PSEL V 31 SSEL V 32 TA RFC1006 127 0 0 1 PORT 22800 T SMP22800 29 30 33 SMP22804 21 PSEL V 34 SSEL V 35 TSEL RFC1006 T SMP22804 36 TSEL LANINET A 22804 37 openUTM Generierung UTMD APT 1 2 4 25 ACCESS POINT OSIREP8 40 P SEL NONE 31 S SEL NONE 32 T SEL SMP22800 z 30 T PROT RFC1006 TSEL FORMAT T LISTENER PORT 22800 29 AEQ 1 26 OSI CON SMP22804 P SEL NONE 34 S SEL NONE 35 T SEL C SMP22804 36 N SEL C local 38 LOCAL ACCESS POINT OSIREP8 40 T PROT RFC1006 LISTENER PORT 22804 37 TSEL FORMAT T OSI LPAP ACICSO4A 41 OSI LPAP ACICS04 41 APPLICATION
12. 132 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren Start eines CICS Dialogvorgangs aus einem UTM Anwendungsprogramm 12 Einschrittvorgang mit Transaktionssicherung erste Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP FMH5 Daten gt RECEIVE STATE CSEND SEND lt Daten aS INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE Client PEND FI gt Brepahe gt RECEIVE STATE SYNCFREE SYNCPOINT lt RequestCommit UTM Systemcode Committed gt lt EORIELISFF Fe NORMAL RETURN lt U5461 J Z135 6 133 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 13 Einschrittvorgang mit Transaktionssicherung zweite Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A KCLM 0 CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI FMH5 Daten gt RECEIVE STATE SEND SEND Daten Prepare gt gt RECEIVE STATE SYNCFREE SYNCPOINT RequestCommit Committed gt Forget NORMAL RETURN Im Beispiel 13 sieht das 3 Teilprogramm ob CICS Commit oder Rollback gegeben hat Im Beispiel 12 erf hrt das Teilprogramm von Commit oder Rollback in C
13. Im CICS Sprachgebrauch ein Anwendungsprogramm das von einem anderen Anwendungsprogramm mittels LU6 oder LU6 2 gestartet wird Bei openUTM wird statt dessen der Begriff Auftragnehmer Vorgang verwendet R cksetzen einer Transaktion Basic conversation Bidder BIND Typ einer LU6 2 Conversation bei dem das Anwendungsprogramm die Verpak kung der Daten mittels GDS selbst durchf hren muss Gegenteil Mapped Conversation Basic Conversations werden blicherweise nicht von normalen Anwendungsprogrammen sondern nur von Systemprogrammen benutzt Der Wiederanlauf Resync im LU6 2 Protokoll ist z B mit basic conversation reali siert Synonym f r contention loser Gegenteil first speaker SNA Nachricht die beim Sessionaufbau von der primary LU an die secondary LU gesendet wird Die secondary LU antwortet mit einem BIND Response Mit die sen beiden Nachrichten werden alle Eigenschaften der Session festgelegt unter anderem der Typ der Session z B LU6 1 oder LU6 2 Pacing RU Sizes Sync Level Mode Name Contention Winner Contention Loser Bracket Protokoll Das Bracket Protokoll in SNA ist eine Vereinbarung wie mehrere Nachrichten innerhalb des Datenflusses einer LU LU Session zu einer Verarbeitungseinheit zusammengefasst werden Das Bracket Protokoll unterst tzt den Austausch von transaktionsorientierten Nachrichten mit Richtungswechseln bei einer Auf traggeber Auftragnehmer Beziehung Chain of RUs Festlegung innerhal
14. Protokollfehler fehlerhafter Aufbau der Session PDU oder fehlerhafter SPDU Parameter 16 S_PICSREST Versto gegen implementierungsbedingte Beschr nkungen 404 O_REM_SESS Der Verursacher ist der entferne Session Provider amp XP1INFO kann folgende Werte annehmen 1 S_TCDISCON transport disconnect 4 S_PROTERROR protocol error 8 S_UNDEFINED undefined 16 S_PICSREST violation against restriction stated in PICS 405 O_LOC_PRES Der Verursacher ist der lokale Presentation Provider amp XP1INFO kann folgende Werte annehmen 0 P_ARRNO reason not specified Ein intern angeforderter Dekodierpuffer kann wegen Speichermangel nicht bereitgestellt werden Uberlauf des internen Datenpuffers beim Reassemblieren von fragmentierten Nachrichten Ein unbekanntes Session Ereignis wurde angezeigt Systemengpass oder Systemfehler 1 P_ARNRPDU unrecognized PPDU Es sind keine Session Userdaten vorhanden oder es kann deren Presentation Teil nicht dekodiert werden Systemfehler 4 P_ARNRPAR unrecognized PPDU parameter Fehler beim Dekodieren der ACSE Presentation oder einer Benutzersyntax 5 P_ARNEPAR unexpected PPDU parameter PPDU Parameter nicht im normal mode U5461 J Z135 6 327 Meldungen des XAP TP Providers Meldungen von openUTM LU62 XPINI Bedeutung 6 P_ARNIPAR invalid PPDU parameter Ungiltiger context identifier beim Deko
15. REMOTE ATTRIBUTES REMOTESYSTe REMOTEName REMOTESYSNet CONNECTION PROPERTIES ACcessmethod Vtam PRotocol Appc Conntype SInglesess No DAtastream User RECordformat U Queuelimit No Maxqtime No OPERATIONAL PROPERTIES AUtoconnect No INService Yes SECURITY SEcurityname ATtachsec Local BINDPassword 5 BINDSecurity No Usedfltuser No RECOVERY PSrecovery Sysdefault 3 1 4 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren O NN S C EDA View Sessions CGEI4 Sessions CGEI4 Group KNAS1IND DEscription ESSION IDENTIFIERS Connection IDI4 SESSName ETnameq 7 Odename MODDIS89 ESSION PROPERTIES Protocol Appc Aximu 015 015 RECEIVEPfx RECEIVECount SENDPfx SENDCount SENDSize 04096 RECEIVESize 04096 SESSPriority 000 Transaction PERATIONAL PROPERTIES Autoconnect Yes INservice Buildchain Yes USERArealen 000 IOarealen 00000 00000 RELreq o DIscreq No EPclass 000 ECOVERY RECOVOption Sysdefault RECOVNoti fy one EDA View PROGram UTMCICS1 PROGram UTMCICS1 Group KNASIIND DEscription Language CObol RELoad No RESident o USAge ormal USE pacopy o Status Enabled RSI 00 Cedf Yes DAtalocation Below EXECKey User 1 5 6 7 7 8 U5461 J Z135 6 85 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6
16. RPRN AA 256 U5461 J Z135 6 9 Fehlerdiagnose In diesem Kapitel finden Sie die Hinweise zur Fehlerdiagnose 9 1 Diagnosehilfsmittel Bei Kommunikationsproblemen zwischen der UTM Anwendung und der Partner Anwen dung im IBM System sollten Sie folgende Diagnosehilfsmittel nutzen 1 Das Kommando u62_sta zum berpr fen des Status von openUTM LU62 Dieses Kommando ist auf Seite 58 beschrieben Bei Verwendung von TRANSIT das Kommando SNA_status zum berpr fen des Sta tus von TRANSIT Dieses Kommando ist im Handbuch TRANSIT SERVER beschrie ben Bei Verwendung von SNAP IX oder des IBM Communications Server die Status Anzei ge Funktionen dieses Produkts Die SYSLOG Datei der UTM Anwendung Siehe hierzu die entsprechenden UTM Handb cher Bei Verwendung von openUTM LU62 f r UNIX Systeme die Diagnosedateien opt 1ib utml u62 PROT prot luname Bei Verwendung von openUTM LU62 f r Windows Systeme die Diagnosedateien Programme utmlu62 PROT prot uname txt Die in diesen Dateien vorkommenden Meldungen sind ab Seite 264 beschrieben Bei Verwendung von openUTM LU62 mit TRANSIT die Diagnosedateien opt lib transit PROT prot nukleus opt lib transit PROT prot 1u62 opt lib transit PROT cnos mlog Siehe hierzu die TRANSIT Handb cher Bei Verwendung von SNAP IX oder des IBM Communications Server die Protokollan zeigefunktion dieses Produkts U5461 J Z135 6 257 Diagnosehilfsmittel Fehlerdiagnose
17. amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_poll fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 apext_adm operation code amp OPCODE fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 amp OPCODE bezeichnet die Kennung des Ad ministrationsaufrufs apext_att fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 apext_det fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 apext_init fuer Typ amp INITTYPE fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 amp INITTYPE bezeichnet den Typ der zu initiali sierenden Daten Die Dump Datei amp FILENAME kann nicht geoeffnet werden u62_tp hat erfolglos versucht aufgrund eines schwerwiegenden internen Fehlers oder angesto en durch ein Administrationskommando einen Dump seiner Kontroll bl cke in die Datei amp FILENAME auszugeben Diese Datei konnte jedoch nicht ge ffnet werden 282 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp 100 Meldung amp MSGNUM des XAP TP Providers Diese Meldung leitet eine Systemmeldung des XAP TP Providers ein Der Folge text ist abh ngig von der Meldungsnummer amp MSGNUM Die einzelnen Meldungen des XAP TP Providers sind ab Seite 316 in einem eigenen Abschnitt aufgelistet Meldungen der Komponente
18. 52 53 54 55 56 57 Fehler beim Oeffnen des Meldungskatalogs amp CATNAME errno amp ERRNO amp ERRTXT F r die mit dem Kommando u62_adm f angesto ene Auswertung der bin ren Trace Datei ist der Meldungskatalog amp CATNAME notwendig der sich nach einer er folgreichen Installation von openUTM LU62 im Verzeichnis opt 1ib n1s msg En befindet Wenn der Katalog von u62_adm nicht ge ffnet werden kann ist der Katalog in der Regel von Hand gel scht worden oder es sind die Zugriffsrechte manuell ver ndert worden Der Inhalt amp ERRNO der Variablen errno gibt jedenfalls genaueren Aufschluss dar ber Fehler beim Oeffnen der Tracedatei amp FILENAME errno amp ERRNO amp ERRTXT Fehler beim Lesen der Tracedatei amp FILENAME errno amp ERRNO amp ERRTXT Aus der bin ren Trace Datei amp FILENAME konnte ein Trace Record nicht gelesen werden die weitere Auswertung der Datei wird abgebrochen Diese Meldung kommt vor wenn es sich bei amp FILENAME um keine Trace Datei einer Instanz von openUTM LU62 handelt oder wenn die Trace Datei nicht vollst ndig beschrieben ist Ein vollst ndiges Beschreiben bewirkt man mit u62_adm tf1 IN oder mit u62_adm tof INJ Au erdem wird der Trace bei Beendigung von openUTM LU62 vollst ndig weggeschrieben einzige Ausnahme kill 9 lt PID von u62_tp gt Nicht genuegend Speicher vorhanden Diese Fehlermeldung tritt nur in Verbindung mit dem Schalter fzur Auswertung von Trace D
19. FMPROF X 13 TSPROF X 07 PRIPROT X BO SECPROT X BO COMPROT X 50B1 RUST ZES X 8989 TYPE X 00 PSERVIC X 060200000000000000002CDO PSNDPAC X 04 SRCVPAC X 04 SSNDPAC X 04 COS NORMCOS MODEEND TRANSIT Generierung XLINK LO2CGE TYP LAN XID 0172000E XPU PO2CGE TYP PEER LINK LO2CGE DMAC 400037450001 AXDATA 1033 XLU TO2CGEIA TYP 6 SESS CTR IND SESS LMT 20 PUCONNECT APHSTART NETNAME DESNIO00 TO2CGEI4 SEC PAIR NO_CHECK NO_PASS PAIR_EXT CICST6 MODDIS89 SYNCLEVEL ALREADY_VERIFIED XRLU CICST6 NETNAME DESNIO00 A9CICST6 PU PO2CGE XMODE MODDIS89 SESS MAX 15 SESS LOS 2 SESS WIN 2 SESS AUTO 2 SRU MAX 89 RRU MAX 89 15 5 7 11 12 17 6 8 3 9 nananana 6 4 43 5 20 20 3 43 17 5 6 7 7 88 U5461 J Z135 6 openUTM CICS Kop plung ber LU6 2 openUTM CICS Kopplung generieren openUTM LU62 Generierung ohne Verwendung von TNSX INSTANC T LOC LU ALIAS LOC TSEL LOC LISTENER PORT LOC APT LOC AEQ EM LU ALIAS AME COD TSEL LISTENER PORT NSEL APT AEQ PL CONTEXT SOCIATIONS NECT CONTWIN OSITP CODE D D 6 m I mm gt gt U X a aE 02 dA Da oO oO CICST6 TO2CGEIA T SMP22804 22804 C12 30 s 1 MODDIS89 EBCDIC 273 T SMP22800 22800 localhost 1 2 4 UDTSEC 15 5 ASCII
20. HPR YES PUTYPE 2 S I G F FF F F PATH2A PATH SAPADDR 8 ie PADDR 111 22 333 144 RPNM GPP390 i 182 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren 5 1 6 LU6 2 Security Unter LU6 2 Security versteht man das Sch tzen von Transaktionen gegen unerlaubte Zu griffe Beim Aufbau einer Conversation gibt es 3 Security Varianten e NONE Es wird keine Userid mitgegeben e ALREADY_VERIFIED Es wird eine Userid mitgegeben und ein Already Verified Indi kator der dem Auftragnehmer mitteilt dass der User beim Auftraggeber bereits verifi ziert wurde e PROGRAM Es wird eine Userid und ein Passwort mitgegeben IMS verwendet das Produkt RACF zur Zugriffskontrolle Userids die von Partner Anwen dungen gesendet werden m ssen somit immer in RACF eingetragen sein Welcher User welchen Transaktionscode aufrufen darf ist in RACF eingetragen Auch die Passworte zu den Userids sind in RACF eingetragen Ob beim Aufbau einer LU6 2 Conversation zu IMS eine Userid und eventuell ein Passwort mitgegeben werden m ssen ist im Parameter SECACPT des VTAM APPL Makros festge legt Details zur RACF Pr fung von eingehenden Conversations sind im Parameter RACF der TP_Profile Definition festgelegt 5 1 7 Vollst ndiges Generierungsbeispiel Das folgende Beispiel enth lt die Generierungsanweisungen einer openUTM IMS Kopp lung mit folgenden Randbedingungen e openUTM LU62 l uft auf einem Wind
21. INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PGWT KP FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED SRRBACK CMSDT CM_DEALLOCATE_ABEND CMDEAL lt FMH7 FMH7 Response gt KCTARB Y MGET NT KCRN gt A VGST T TAST R MPUT Client PEND KCOM FR Im Gegensatz zu Beispiel 17 erh lt das Teilprogramm im Beispiel 18 nach dem R cksetzen durch CPI C eine R ckmeldung zur Kontrolle U5461 J Z135 6 169 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 19 CPI C Anwendungsprogramm setzt Transaktion zur ck Vorgang l uft weiter gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP EMHS DaLeN gt CMACCP CMRCV gt CM_SEND_RECEIVED CMSEND lt Daten ee INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A CTRL PR KCRN gt A PEND KP Prepare gt gt CMRCV gt CM_TAKE_COMMIT SRRCMIT lt RequestCommit INIT MGET NT KCRN gt A VGST 0 TAST P MPUT NE Client PEND RE Committed gt lt Forget RR_OK DL gt INIT MGET Client MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP Prepare gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRBACK Fortsetzung n chste Seite 170 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C Fo
22. LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren Das UTM Anwendungsprogramm hat nach MPUT NE ein CTRL PE und ein PEND KP abgesetzt Der CTRL PE ist als TP_DEFERRED_END_DIALOGUE_IND und TP_PREPARE_IND zu sehen MC_SEND_DATA tpid 00984982 lt 10 46 42 line 3757 corr 1 send_type SEND_DATA_P_TO_R_FLUSH data_type PS_HEADER Prepare openUTM LU62 sendet ein Prepare an das CICS Anwendungsprogramm und fordert es somit zum Einleiten des Transaktionsendes auf MC_RECEIVE_IMMEDIATE tpid 00984982 gt 10 46 45 line 3835 corr 1 what_rcvd PS_HEADER_COMPLETE Request Commit MC_RECEIVE_AND_POST tpid 00984982 gt 10 46 45 line 3902 corr 1 what_rcvd SEND Das CICS Anwendungsprogramm hat das Transaktionsende mit dem CICS Kommando SYNCPOINT best tigt CICS sendet deshalb ein Request Commit und gibt das Senderecht ab TP_PREPARE_ALL_REQ fd 0 10 46 45 line 3932 corr gt TP_READY_ALL_IND fd 0 10 46 45 line 4009 corr lt udata_len 99 TP_COMMIT_REQ fd 0 10 46 45 line 4261 corr gt openUTM LU62 sendet den Request Commit als TP_COMMIT_REQUEST an die UTM Anwendung weiter Dies beendet die erste Phase des 2 Phase Commit Protokolls Die vor ausgehenden XAP TP Aufrufe TP_PREPARE_ALL_REQ und TP_READY_ALL_IND sind nur lokaler Natur TP_COMMIT_IND fd 0 10 46 47 line 4337 corr 1 lt
23. Namen angesto en unabh ngig davon ob die Zahl der Sessions zum LU6 2 Part ner inzwischen auf 0 gesunken war oder nicht Wenn der Formatfehler immer wieder auftritt ist keine transaktionsgesicherte Kom munikation mit dem LU6 2 Partner m glich Die Partner LU Alias Name amp ALIASNAME Netzname amp NETNAME hat einen Protokollverstoss in einer von der lokalen LU abgeschickten Syncpoint Nachricht festgestellt Die Partner LU Alias Name in der LU6 2 Basis Software und openUTM Genrie rung amp ALIASNAME Netzwerkname im SNA Netz amp NETNAME hat in einer Syncpoint Nachricht von openUTM LU62 einen Formatfehler festgestellt Die Re aktion von openUTM LU62 ist dieselbe wie in Meldung 513 beschrieben Abweisen der wartenden OSI TP Dialoge mit Functional Unit Commit aber Wie derholung des Austauschs der Log Namen bei der n chsten Gelegenheit Wenn der Formatfehler immer wieder auftritt ist keine transaktionsgesicherte Kom munikation mit dem LU6 2 Partner m glich U5461 J Z135 6 311 Meldungen des Programms u62_tp Meldungen von openUTM LU62 516 520 521 523 Ein Austausch der Log Namen mit der LU Alias Name amp ALIASNAME Netzname amp NETNAME ist fehlgeschlagen Diese LU hat einen kalten Exchange Logname gesendet Die Ursache war vermutlich ein vom Partner festgestellter warm kalt Fehler Die Partner LU Alias Name in der LU6 2 Basis Software und UTM Generierung amp ALIASNAME Netz
24. SEND LAST CONVID SYNCPOINT FMH5 Daten RequestCommit gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P PEND FI lt Committed NORMAL SEND Client 2a RETURN 124 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 3 Zwei Transaktionen in einem Vorgang erste Variante gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND INVITE CONVID SYNCPOINT FMH5 Daten RequestCommit gt INIT PU ENDTA C SEND Y MGET VGST 0 TAST P MPUT NE PEND RE lt Committed Daten NORMAL RECEIVE CONVID SEND Client RECEIVE Client SEND LAST CONVID SYNCPOINT Daten RequestCommit gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P PEND FI lt Committed NORMAL SEND Client oe RETURN U5461 J Z135 6 125 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 Zwei Transaktionen in einem Vorgang zweite Variante gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND INVITE WAIT CONVID FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST 0 MPUT NE PEND KP lt Daten RECEIVE CONVID SYNCPOINT RequestCommit gt INIT PU ENDTA R SEND N MGET VGST 0 TAST P PEND RE lt Committed NORMAL SEND Client RECEIVE Client SEND LAST CONVID SYNCPOINT Daten RequestCommit
25. SENDCOUNT 01 Fur diese Session ist die CICS Anwendung SLU secondary logical unit und contention winner In der korrespondierenden SESCHA Anweisung der UTM Ge nerierung muss PLU N CONTWIN Y angegeben werden Bei einer Kopplung Uber TRANSIT CLIENT ist dies nicht zul ssig SENDSIZE RECEIVESIZE ru_size Damit wird die maximale Gr e der request units RU f r diese Session festgelegt Der Wert f r RU Size wird bestimmt durch die maximale Datenl nge einschlie lich der Function Management Header FMH Die Function Management Header haben eine Gr e zwischen 7 und 50 Bytes Bei einer Kopplung ber TRANSIT CLIENT sollte hier jeweils der Wert 1024 gew hlt werden AUTOCONNECT NO YES Die Verbindungen werden automatisch beim Start von CICS aktiviert YES oder nicht NO BUILDCHAIN YES Dieser Operand muss f r alle openUTM CICS Sessions angegeben werden IOAREALEN value1 value2 A Mit value wird die Mindestgr e der Terminal Input Output Area von CICS festge legt Dieser Wert sollte mindestens so gro gew hlt werden wie die mit maximale Nachrichtenl nge der Anwendungsprogramme Bei einer Kopplung ber TRANSIT CLIENT muss CICS immer PLU sein d h RECEIVECOUNT 1 Die maximale RU size darf 1024 Bytes nicht berschreiten Au erdem wird pro CONNECTION nur eine SESSION zugelassen keine parallelen Sessions Wenn der Datentransfer ber mehr als eine Session verteilt werden soll so m ssen mehrere CONNECTION d
26. Se Bese Sow A ee a es 197 5 2 6 Ablauf Beispiele mit CPI C Programmen 2 2 2 2 En nn 203 52 7 Ablauf Beispiele mit Standard IMS Transaktionen 22 222 nenn 204 5 2 8 Ablauf Beispiele mit IMS als Auftraggeber aoaaa a 206 5 3 IMS Adminlstralon 2 0 ee EA pasponi nikaren wa 208 6 openUTM CICS Kopplung ber LU6 1 2 2 2 nummer nn 209 6 1 CICS Definitionen f r openUTM CICS Sessions 2 2005 209 DEFINE CONNECTION 24 2 84 48 ah 446 62 498 d 210 DERNE SESSIONS 126550 4 BORER MOE EO Be Oe OE wee OOD EA 211 Beispiel zu Abh ngigkeiten von CICS und UTM Generierung 213 6 2 TRANSIT Generierung f r openUTM CICS Sessions 5 214 6 3 Definieren von CICS Transaktionen 2 nun 216 6 3 1 Lokale Tanmsaklonen 6 4 rear a en rt a 216 6 3 2 Feme Tansaklonen u ua sn oe dR SEE SEER ROR En ande 217 U5461 J Z135 6 Inhalt 6 4 6 4 1 6 5 6 6 6 7 6 8 6 9 6 10 7 1 FAA 7 2 CICS Programmierung bei Kopplung mitopenUTM 218 Regeln und Restriktionen bei CICS Programmierung 04 218 CICS Kommandos f r CICS Auftraggeber Vorg nge 222 n 220 SELL ATE vee acc 2 ee ee pa Se eh SS 220 BUILD ATTACH 00 2 00 0 em a ee Baw 221 SEND 2 5 seks Haw ER RI EN Oe RS 222 FE ENEs hg oat ao es Oe ee EG ee 223 Re Er a es ee aris ear irae Gees Bk es Be es we ae A 224 EXTRACT AITACH 2 2 2 nce 6 eee ao HS SER neh 225 SITICPONIT ru 6 ee aoe ke ee ERR AR eS ee e
27. Standardm ig wird diese Datei im Verzeichnis lt Installationsverzeichnis des IBM Communications Servers for Windows gt PRIVATE abgelegt Generierung von IBM Communications Server for Windows NODE ANYNET_SUPPORT NONE COMPRESS_IN_SERIES 0 CP_ALIAS P02CG DEFAULT_PREFERENCE NATIVE DISCOVERY_SUPPORT DISCOVERY_CLIENT DLUR_SUPPORT NORMAL FQ_CP_NAME DESNI000 PO2CGE 17 43 AX_LS_EXCEPTION_EVENTS 200 ODE_ID 0172000E 11 12 ODE_TYPE END_NODE U 17 m m REGISTER _WITH_CDS 1 REGISTER _WITH_NN ALL TP_SEC RITY_BEHAVIOR VERIFY_EVEN_IF_NOT_DEFINED PORT PORT_NAME LANO_04 16 ACTIVATION_DELAY_TIMER 0 DELAY_APPLICATION_RETRIES 1 DLC_DATA 00000000000004 DLC_NAME LAN IMPLICIT_BRA IMPLICIT_CP_CP_ IMPLICIT_DEAC IMPLICIT_DSPU_ IMPLICIT_HPR_S IMPLICIT_LIMI IMPLICIT_LIN LINK_STATION_ MAX_ACTIVATION_A MAX_IFRM_RCVD 8 MAX_RCV_BTU_SIZE 1033 13 PORT_TYPE SATF m EXTENDER_LINK 0 ESS_SUPPORT 1 IMER 0 ICES NONE PORT 1 ESOURCE NO ERROR 0 EGOTIABLE EMPTS 0 GD I wv a lt oum ul 7 On mic a wD amel U5461 J Z135 6 93 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 RETRY_LINK_ON_DISCONNECT 1 RETRY_LINK_ON_FAILED_START 1 RETRY_LINK_ON_FAILURE 1 PORT_LAN_SPECIFIC_DATA ACK_DELAY 100 A A HH X u YOO sZt CK_TIME DAPTER OUT 10000 NUMBER
28. a s s gt s sr eee ee RE Ra a a nn 40 3 1 5 Einschr nkungen bei der Protokollabbildung aooaa a a 41 3 2 openUTM LU62 generieren 2 2 0 2 eee eee ee es 42 3 2 1 Aufbau der Generierungsdatei 2 2222 mann nn 42 3 2 2 INSTANCE Anweisung Oe ee ee ee Der ee eh 43 3 2 3 Generierungsprogramm starten aooaa a a a 52 3 2 4 Generierungsdatei wiederherstellen Teer eee ee se 53 32 5 Namen der verwendeten Generierungsdatei anzeigen 2 2222 53 3 3 openUTM LU62 administrieren aaoo 54 3 3 1 Administration unter UNIX und Windows Systemen 2 2 2 nn 54 3 3 2 openUTM LUGZ Staren gt o 50 0 2 kee er ee ee he 55 3 33 openUTM LU62 beenden 4 5 HH ar a ne SESE SEE SS 57 3 3 4 Zustandsinformationen anzeigen 2 mn nenn 58 3 3 5 Verbindungen aufbauen 2 2 222mm nn nn 61 3 3 6 Verbindungen SOOAUEN oa za 2 3m ESE EEE ea 61 3 3 7 Trace ein und ausschalten 2 24 2 252 s bee Ha aan ar ERE 62 3 3 8 MIR SUNT N i ee a Re a en 64 3 3 9 DUMP erzeugen u 0 a au eee RRR ER REE EE SR EE ee Ye GOS 65 3 3 10 lage 113 2 27 17275 gt Se bot bd bw ee eee ow doe bee eS ee ok 66 4 openUTM CICS Kopplung ber LU6 2 00 2 0002 ee eee 75 4 1 openUTM CICS Kopplung generieren 2 2 2 m nn nn 75 4 1 1 Definitionen in CICS ince ce woke eR AE Ee RE eR anne 5 DEFINE CONNECTION aa aan e080 ee HEE POS EBS OE ROS pee a JO BEFINESESSICHE ox a4 ean Ae oe BR oe ORE Rohe eee eee ee 78
29. ber einstimmen MSGDEL SYSINFO spezifiziert welche Message Typen nicht gesendet werden F r die Kopplung mit openUTM muss SYSINFO angegeben werden OPTIONS TRANRESP FORCSESS FORCSESS spezifiziert den Session Wiederanlauf Fur die Kopplung mit openUTM muss FORCSESS angegeben werden TRANRESP ist f r den Dialog mit IMS Transaktionen erforderlich Standard COMPT1 SINGLE1 DPM Bn SINGLE1 spezifiziert bei Ausgabe das Bracket Protokoll F r die Kopplung mit openUTM muss SINGLE1 angegeben werden DPM Bn gibt an ob MFS Distributed Presentation Management zur Verf gung steht Wird dieser Parameter nicht angegeben wird VLVB angenommen Eine zu sendende Nachricht an ein UTM Anwendungsprogramm muss dann in den ersten 8 Zeichen den UTM Transaktionscode enthalten eventuell mit Blanks am Ende Dem UTM Anwendungsprogramm wird die komplette Nachricht im Nachrichtenbe reich zur Verf gung gestellt inklusive Transaktionscode SEGSIZE size Size gibt die Gr e eines Eingabesegmentes an Der Wert muss mindestens so groB sein wie die maximale Nachrichtenteillange in den UTM Anwendungspro grammen U5461 J Z135 6 239 IMS Generierung f r openUTM IMS Sessions openUTM IMS Kopplung ber LU6 1 OUTBUF buffer size buffer size beschreibt die Gr e des Ausgabe Puffers Dieser Wert muss kleiner oder gleich dem Wert TRMSGLTH der MAX Anweisung der UTM Generierung sein Zul ssige Werte f r buffer size sind dem Handbuch IMS
30. ds_send_alert_q_size 100 cos_cache_size 24 tree_cache_size 40 tree_cache_use_limit ax_tdm_nodes 0 ax_tdm_tgs 0 ax_isr_sessions 1000 isr_sessions_upper_threshold isr_sessions_lower_threshold isr_max_ru_size 16384 isr_rcv_pac_window 8 store_endpt_rscvs NO store_isr_rscvs NO store_dlur_rscvs NO cos_table_version VERSION_O_COS_TABLES send_term_self NO disable_branch_awareness NO 900 800 U5461 J Z135 6 97 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 cplu_syncpt_support YES cplu_attributes NONE dlur_support NO pu_conc_support YES nn_rar 128 max_ls_exception_events 0 ptf_flags NONE Ldefine_ethernet_dIc dlc_name ETHERO description neg_ls_supp YES initially_active NO adapter_number 0 lan_type 802_3_DIX Ldefine_ethernet_port port_name ETSAPOA description dlc_name ETHERO port_type PORT_SATF port_number 0 nax_rcv_btu_size 1033 tot_link_act_lim 64 inb_link_act_lim 0 out_link_act_lim 0 Is_role LS_NEG implicit_dspu_services NONE implicit_dspu_template implicit_ls_limit 0 act_xid_exchange_limit 9 nonact_xid_exchange_limit 5 Is_xmit_rcev_cap LS_TWS nax_ifrm_rcvd 7 target_pacing_count lsap_address 0x04 nax_send_btu_size 1033 nac_address lt 000000000000 gt implicit_cp_cp_sess_support NO mplicit_limited_resource NO mplicit_deact_
31. 035 036 Die Synclog Datei amp SYNCLOG bleibt unveraendert da die CCR Syntax nicht mehr konfiguriert ist W hrend des Warmstarts wird festgestellt dass von einem vorangegangenen Start von openUTM LU62 noch eine Synclog Datei amp SYNCLOG vorhanden ist Da in der Zwischenzeit der Application Context von UDTCCR oder UDTSEC nach UDTAC oder UDTDISAC ge ndert wurde Parameter APPL CONTEXT so dass keine Transaktionssicherung mehr notwendig ist l sst openUTM LU62 die Synclog Datei vorsichtshalber unver ndert liegen und setzt die Initialisierung fort Falsches Format der Synclog Datei amp SYNCLOG Kaltstart empfohlen openUTM LU62 stellt w hrend des Warmstarts fest dass die Version der Synclog Datei nicht mit der Version des Programms u62_tp bereinstimmt nur nach Instal lation einer neuen Version von openUTM LU62 m glich oder dass es sich bei amp SYNCLOG um keine oder um eine besch digte Synclog Datei handelt Daf r gibt es nur zwei plausible Erkl rungen Entweder ist die Datei gar nicht von openUTM LU62 sondern von einem System User erzeugt worden oder die Datei konnte wegen Platzmangels im Dateisystem nicht vollst ndig auf Platte geschrieben werden und ist daher abgeschnitten openUTM LU62 bricht daraufhin die Initialisierung ab Da mit der vorliegenden Synclog Datei kein Warmstart m glich ist sollte open UTM LU62 anschlie end kalt gestartet werden Die Eintraege in der Synclog Datei amp SYNCLOG sind nicht mit de
32. Beispiele zu Abh ngigkeiten bei der openUTM IMS Generierung 242 TRANSIT Generierung f r openUTM IMS Sessions 243 U5461 J Z135 6 Inhalt 7 3 Generieren von IMS Transaktionen 222m 243 Makro TRANSACT era maaa e a e e a a e a e a e 243 7 4 IMS Programmierung bei Kopplung mit openUTM 2 22 0000 244 7 4 1 Kopplungsm glichkeiten mit IMS aaa a 244 7 4 2 IMS AUNUTS 2 cee eh Ree AR Re Rew een 245 7 4 3 Vergleich mit KDCS Aufrufen 2 on on nn 245 7 4 4 Beispiele f r die openUTM IMS Kommunikation 2 222 nn 246 7 4 5 Beispiele f r den Austausch von Asynchron Auftr gen 247 7 4 6 Hinweise zur openUTM IMS Programmierung 0 2 0 00 248 8 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen 249 8 1 Programmschnittstelle f r openUTM 2222000 nn 251 INFO GN os eu Soh dota Ei Ge aoe Ge Ge oe ho LE 252 IPFOIN seg eae era herren 253 8 2 bergabe der FMH6 Parameter in openUTM IMS und CICS 255 8 2 1 Behandlung des Transaktionscodes in openUTM 2 22 aaa 255 8 2 2 Behandlung des Transaktionscodes in IMS 2 22 aaa a 256 8 2 3 Behandlung des Transaktionscodes in CICS 2 2 nn nn 256 9 Fehlerdlagnose hut ead wre Br er ds Dee eS 257 9 1 Diagnosehilfsmittel 222000 nn nn 257 9 2 LUG Sense Data 2 45 4a eh ds garen eat e ed cet ee han nen 259 10 Meldungen von openUTM LU62 2 2 0 2 ee eee ee ee es
33. Dieses Kommando hat dieselbe Wirkung wie die Kom mandofolge SEND INVITE RECEIVE Das Kommando hat folgende Syntax EXEC CICS CONVERSE CSESSION name J FROMLENG TOLENGTH LATTACHID name LFROM bereich H bereich LINTOCbereich SET pntr bereich LMAXLENGI IH bereich LNOTRUNCATE Die Parameter haben die gleiche Bedeutung wie bei dem SEND bzw RECEIVE Komman do beschrieben 224 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r CICS Auftraggeber Vorg nge EXTRACT ATTACH Dieses Kommando wird verwendet um Informationen aus dem empfangenen ATTACH Header zu lesen Indikator EIBATT im EIB nach RECEIVE Das Kommando hat folgende Syntax EXEC CICS EXTRACT ATTACH RECFM data area Ein von openUTM gesendeter FMH5 enth lt nur Information ber das verwendete Nach richtenformat In anderen Feldern siehe CICS for MVS ESA Application Programming Re ference werden nach dem Aufruf keine Informationen geliefert RECFM data area Dieser Parameter bezeichnet ein zwei Byte langes Feld das in dem niederwertigen Byte Information f r den Entblockungsalgorithmus im CICS Anwenderprogramm enth lt Der Wert X 01 bedeutet dass die Daten im VLVB Format variable length variable blocked vorliegen openUTM schickt die Daten im VLVB Format wenn KCDF 0 und KCMF Leerzeichen beim MPUT gesetzt wurde Jeder mit je einem MPUT NT NE erzeugte Nachrichtenteil enth
34. Funktion amp FUNK Fehlercode amp ERRNO amp ERRTEXT Service amp SERVICENAME erfolgreich installiert Die Meldungen 30 und 31 erscheinen nach Eingabe des Kommandos u62_start r Stoppen des Service amp SERVICENAME Diese Meldung erscheint nach Eingabe des Kommandos u62_start r wenn openUTM LU62 gerade l uft Danach wird jede Sekunde ein Punkt ausgegeben bis sich der Dienst tats chlich beendet hat Service amp SERVICENAME ist jetzt gestoppt Service amp SERVICENAME kann nicht gestoppt werden Fehlercode amp ERRNO amp ERRTEXT Hinweis nach dem Kommando u62_start u ob openUTM LU62 erfolgreich ge stoppt werden konnte Im Fehlerfall wird der Error Code amp ERRNO der Systemfunk tion QueryServiceStatus ausgegeben Service amp SERVICENAME erfolgreich entfernt 346 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen von u62_start 36 37 38 39 Fehler beim Entfernen des Service amp SERVICENAME Funktion amp FUNKNAME Fehlercode ERRNO amp ERRTEXT Hinweis ob openUTM LU62 erfolgreich als Dienst entfernt werden konnte Im Feh lerfall wird der Name der Systemfunktion ausgegeben die den Fehler verursacht hat OpenSCManager OpenService oder DeleteService dazu der Fehlercode amp ERRNO Fehler bei der Bekanntgabe des Service Handlers Funktion amp FUNKNAME Fehlercode amp ERRNO amp ERRTEXT Wurde openUTM LU62 als Dienst gestartet muss es dem System eine Funktion bekanntgeben d
35. Im folgenden Bild ist diese Architektur dargestellt CICS Anwendung CICS API CICS openUTM LU62 APPC Bibliothek Kommunika tionssoftware z B VTAM LU6 2 Basis Software XAP TP Provider LU6 2 Verbindung OSI TP Verbindung UTM Anwendung KDCS openUTM XAP TP Provider CMX oder BCAM Architektur von openUTM LU62 Die fett umrandeten K stchen stellen Rechnergrenzen dar Linien innerhalb eines K st chens bezeichnen Grenzen zwischen den verschiedenen Software Komponenten teilwei se ist der Name der Programmschnittstelle auf der Linie in Klammern angegeben Wie im Abschnitt Direkte LU6 2 Kopplung ber SNAP IX auf Solaris auf Seite 26 be schrieben k nnen im Falle von openUTM unter UNIX und Windows Systemen der mittlere und der rechte Rechner auch identisch sein Zur Kommunikation zwischen openUTM und openUTM LU62 wird dann der Local Loop von CMX ber die IP Adresse 127 0 0 1 benutzt 38 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 Konzepte und Funktionen von openUTM LU62 3 1 3 Komponenten von openUTM LU62 openUTM LU62 besteht aus folgenden Komponenten Das Programm u62_start dient zum Starten der openUTM LU62 Instanzen und der Write Log Prozesse Es berwacht danach die laufenden openUTM LU62 Prozesse Das Programm u62_tp bernimmt die Protokollabbildung zwischen OSI TP und LU6 2 Es wird von u62_start pro openU
36. In diesem Kapitel werden die Aspekte der openUTM IMS Kopplung ber LU6 1 sowie die zugeh rige Generierung und Programmierung behandelt Die Generierung und Programmierung f r eine openUTM IMS Kopplung ist f r den IMS Anwender weitgehend identisch mit einer IMS CICS Kopplung siehe IMS ESA Installation Volume 2 System Definition and Tailoring und IMS ESA Application Programming Tran saction Manager 7 1 IMS Generierung f r openUTM IMS Sessions In diesem Abschnitt werden die wichtigsten IMS Makros beschrieben die zur Generierung einer openUTM IMS Kopplung erforderlich sind U5461 J Z135 6 237 IMS Generierung f r openUTM IMS Sessions openUTM IMS Kopplung ber LU6 1 Makro COMM Dieser Makro beschreibt die grunds tzlichen Anforderungen bez glich der Kommunikation unabh ngig vom Terminaltyp Er muss genau einmal angegeben werden COMM RECANY number size APPLID username EDTNAME name ey andere Parameter Hierbei haben die Operanden folgende Bedeutungen RECANY number size number spezifiziert die Anzahl der VTAM RECEIVE ANY Puffer die im IMS System zur Verf gung stehen size spezifiziert die Gr e dieser Puffer Der Wert von size muss gr er oder gleich dem Wert von TRMSGLTH der MAX Anweisung der UTM Generierung sein Zul ssige Werte f r size sind dem Handbuch IMS ESA Installa tion Volume 2 System Definition and Tailoring zu entnehmen APPLID username 1 8 Zeichen langer Name unter
37. Um den Start als Service r ckg ngig zu machen k nnen Sie folgendes Kommando ver wenden u62_start u openUTM LU62 beenden Mit u62_adm e End wird openUTM LU62 gestoppt Aufrufsyntax opt lib utmlu62 u62_adm e 1 loc_lu_alias_name Beschreibung loc_lu_alias_name Wenn der Schalter I nicht angegeben ist werden alle openUTM LU62 In stanzen gestoppt Ist der Schalter angegeben so wird nur die zur LU loc_lu_alias_ name geh rende Instanz gestoppt Auf Windows Systemen k nnen Sie stattdessen auch Start gt Programme gt openUTM LU62 gt Beenden von openUTM LU62 verwenden Vor dem Beenden von TRANSIT sollten Sie immer openUTM LU62 beenden U5461 J Z135 6 57 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 3 3 4 Zustandsinformationen anzeigen Mit u62_sta k nnen Sie sich ber den aktuellen Zustand von openUTM LU62 informieren Dieses Kommando kann von jedem Benutzer des UNIX Systems verwendet werden Auf Windows Systemen k nnen Sie stattdessen auch Start gt Programme gt openUTM LU62 gt Status Anzeige verwenden Aufrufsyntax u62_sta 1 loc_lu_alias_name c b Beschreibung loc_lu_alias_name Mit dem Schalter 1 werden nur Informationen Uber die zur LU loc_lu_alias_name geh rende Instanz ausgegeben C Mit dem Schalter c wird nur die Anzahl aller LU62 Sessions der lokalen Default LU mit dem Mode CPSVCMG aufgelistet Wird weder der Schalter 1
38. amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Einschalten des Instanz Trace erfolgreich Der Instanz Trace ist bereits eingeschaltet Einschalten des XAP TP Trace erfolgreich XAP TP Trace ist bereits eingeschaltet Ausschalten der Traces erfolgreich Die Traces sind bereits ausgeschaltet Ausschalten des Instanz Trace erfolgreich Der Instanz Trace ist bereits ausgeschaltet Ausschalten des XAP TP Trace erfolgreich XAP TP Trace ist bereits ausgeschaltet Flush der Traces erfolgreich Flush des Instanz Trace erfolgreich Flush des XAP TP Trace erfolgreich Aufbau einer neuen Assoziation angestossen Maximale Anzahl von Assoziationen bereits erreicht Aufbau einer neuen Session angestossen Maximale Anzahl von Sessions bereits erreicht Abbau aller freien Assoziationen angestossen Es gibt derzeit keine freien Assoziationen Abbau aller Sessions angestossen Es bestehen derzeit keine Sessions Abbau aller Assoziationen angestossen Es gibt derzeit keine Assoziationen Fehler beim Oeffnen der Ausgabedatei amp FILENAME errno amp ERRNO amp ERRTXT 352 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen von u62_adm 51
39. d h zum Transaktionscode amp TPNAME der UTM Anwendung aufzubauen Der ferne XAP TP Provider d h von openUTM selbst hat jedoch den OSI TP Dialog abgelehnt so dass bei open UTM LU62 eine TP_BEGIN_DIALOGUE confirmation mit result rejected eingetroffen ist openUTM LU62 beendet daraufhin die Conver sation zum LU6 2 Partner Der Ablehnungsgrund ist in der SYSLOG Datei der UTM Anwendung zu finden Bedeutung von amp RSN 1 kein Grund angegeben 1 Der angegebene TPSU Title Transaktionscode ist beim Partner nicht bekannt 2 Der angegebene TPSU Title Transaktionscode ist beim Partner dauerhaft nicht ver f gbar 3 Der angegebene TPSU Title Transaktionscode ist beim Partner vor bergehend nicht verf gbar 4 Die Partner Anwendung hat ein TP BEGIN DIALOGUE indication ohne Angabe ei nes TPSU Title empfangen 5 Eine oder mehrere der gew nschten Funktionseinheiten Functional Units werden vom Partner nicht unterst tzt 6 Die gew nschte Kombination von Funktionseinheiten Functional Units wird vom Partner nicht unterst tzt 7 Die Association die f r den OSI TP Dialog belegt wurde wird bereits von der Part ner Anwendung benutzt 8 Die Application Entity Parameter die im TP BEGIN DIALOGUE request angegeben wurde identifizieren keine bekannte Application Entity Invocation U5461 J Z135 6 293 Meldungen des Programms u62_tp Meldungen von openUTM LU62 354 355 356
40. den Auftrag Das UTM Anwendungsprogramm kann jedoch selbstverst ndlich nicht mehr benachrichtigt werden Die Transaktionssicherung im Beispiel 24 bringt f r die Anwendungsprogramme gegen ber dem Ablauf ohne Transaktionssicherung Beispiel 23 folgende Vorteile Das Absenden der Asynchron Nachricht im UTM Anwendungsprogramm wird automa tisch mit anderen Abl ufen im Anwendungsprogramm z B mit einem Datenbank Up date gekoppelt Wenn der PEND FI erfolgreich ist wird der CICS Asynchron Vorgang garantiert genau einmal gestartet Dieser Fall ist hnlich zu Beispiel 14 Die CPI C Programmierung ist bei beiden Beispielen identisch Auf UTM Seite hat der Dialog Fall Beispiel 14 den Vorteil dass die Anwendung ber Erfolg oder Misserfolg des Aufrufs informiert wird Der asynchrone Fall Beispiel 24 eignet sich vor allem f r zeitgesteuerte Auftr ge 176 U5461 J Z135 6 5 openUTM IMS Kopplung ber LU6 2 In diesem Kapitel finden Sie die Aspekte der openUTM IMS Kopplung ber LU6 2 bez g lich Generierung und Programmierung IMS ist ein Transaktionsmonitor und eine Daten bank der Firma IBM Seit der Version 6 hat der IMS Transaktionsmonitor IMS TM die F higkeit eine transaktionsgesicherte LU6 2 Kommunikation zu Partner Anwendungen zu betreiben Diese kann genutzt werden bei einer Kopplung zu openUTM 5 1 openUTM IMS Kopplung generieren 5 1 1 IMS Startup Parameter Soll eine IMS Anwendung LU6 2 benutzen so mus
41. dung abgewiesen Dabei ist es unerheblich ob der aufgetretene Fehler nur tempo r rer Natur war z B Sessionverlust des Resync TP oder ob die Log Namen tat s chlich inkonsistent sind Genaueren Aufschluss ber die Ursache gibt jedoch eine Meldung der Komponente RS Resync TP die dieser Meldung vorausgeht OSI TP Dialog durch Partner XAP TP Provider abgebrochen TP Name amp TPNAME LU6 2 Seite ist Auftraggeber OSI TP Dialog durch Partner XAP TP Provider abgebrochen TP Name amp TPNAME OSI TP Seite ist Auftraggeber OSI TP Dialog durch Partner XAP TP User abgebrochen TP Name amp TPNAME LU6 2 Seite ist Auftraggeber 300 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp 393 394 399 OSI TP Dialog durch Partner XAP TP User abgebrochen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Der OSI TP Dialog zwischen openUTM LU62 und dem OSI TP Partner d h der UTM Anwendung ist vom Partner abnormal abgebrochen worden Ist der Verursa cher der ferne XAP TP Provider d h openUTM selbst so ist eine TP_P_ABORT indication empfangen worden Meldungen 390 und 391 Ist der Verursacher der ferne XAP TP User also das Anwendungsprogramm so hat openUTM LU62 eine TP_U_ABORT indication erhalten Meldungen 392 und 393 In allen F llen bricht openUTM LU62 die zugeh rige Conversation zum LU6 2 Partner daraufhin mit De allocate Abend oder Deallocate Resource Failure ab Empfangene Log
42. lt FMH5 Daten GU IOPCB ISRT IOPCB Exit Daten CEB gt MGET NT VGST C KCRN A 2 Asynchroner Aufruf einer IMS Transaktion von openUTM ohne Transaktionssicherung IMS Anwendung UTM Anwendung APRO AM KCOF B KCRN A FPUT NE KCRN A PEND FI lt FMH5 Daten CEB Quittung gt GU IOPCB ISRT IOPCB Exit FMH5 Daten CEB gt lt Quittung TAC DFSASYNC FGET PEND FI F r diese Art der Kommunikation muss eine openUTM LU62 Instanz verwendet wer den die mit dem Parameter UTM ASYNC YES generiert ist Bemerkung Der TAC DFSASYNC muss in der UTM Anwendung als ASYNTAC generiert sein Der Name DFSASYNC ist nicht frei wahlbar sondern wird von IMS vorgegeben 198 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren 3 Asynchroner Aufruf einer IMS Transaktion von openUTM ohne Transaktionssicherung IMS Programm sendet keine Nachricht IMS Anwendung UTM Anwendung APRO AM KCOF B KCRN A FPUT NE KCRN A PEND FI lt FMH5 Daten CEB Quittung gt GU IOPCB Exit F r diese Art der Kommunikation muss eine openUTM LU62 Instanz verwendet wer den die mit dem Parameter UTM ASYNC YES generiert ist 4 Synchroner Aufruf einer IMS Transaktion von openUTM ohne Transaktionssicherung Mehrschritt Transaktion IMS Anwendung UTM Anwendung APRO DM KCOF B KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten GU IOPCB ISRT IOPCB
43. lt ein 2 Byte langes Langenfeld MPUTNT MPUTNT MPUT NE Die Entblockung der Teilnachrichten muss im CICS Programm vorgenommen werden Der Wert X 04 bedeutet dass die Daten im Format Chain of RUs vorliegen openUTM schickt die Daten in diesem Format wenn beim MPUT KCDF ungleich 0 oder KCMF ungleich Leerzeichen angegeben wurde In diesem Fall setzt openUTM vor die Nachricht einen Function Management Header 4 FMH4 Dieser FMH4 enth lt die mit KCDF und KCMF gesendeten Informationen in folgender Weise Byte 0 X 12 L nge des FMH4 Byte 1 X 04 Kennzeichen f r FMH4 Byte 2 5 ohne Bedeutung Byte 6 X 08 L nge des FMHABN Byte 7 14 FMH4BN entspricht KCMF Byte 15 X 02 L nge des FMH4BDT Byte 16 17 FMHABDT entspricht KCDF Jeder mit MPUT NT NE erzeugte Nachrichtenteil muss im CICS Programm mit einem eigenen RECEIVE Kommando abgeholt werden U5461 J Z135 6 225 CICS Kommandos f r CICS Auftraggeber Vorg nge openUTM CICS Kopplung ber LU6 1 SYNCPOINT Das Kommando wird 1 zum Anfordern eines Sicherungspunktes und 2 zum Best tigen eines Sicherungspunktes verwendet Die Kommandofolge SEND SYNCPOINT fordert einen Sicherungspunkt an Die Transak tion ist dann im Zustand PET preliminary end of transaction Die Kommandofolge RECEIVE SYNCPOINT best tigt eine empfangene Aufforderung zum Setzen eines Sicherungspunkts Indikator EIBSYNC
44. umgeneriert und wieder gestartet ist Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Security Daten ungueltig Die LU6 2 Basis Software z B TRANSIT hat die Anforderung zum Aufbau einer Conversation zum LU6 2 Partner abgelehnt weil die Security Daten Benutzerken nung und oder Passwort irgendwelche Sonderzeichen enthalten oder weil der Part ner beim Aufbau der Session angezeigt hat dass er keine Security Daten unter st tzt amp TPNAME ist in diesem Fall z B der CICS Transaktionscode U5461 J Z135 6 287 Meldungen des Programms u62_tp Meldungen von openUTM LU62 323 330 331 332 333 Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Der Sync Level amp SYNCLEVEL wird von der LU6 2 Basis Software nicht unterstuetzt Die LU6 2 Basis Software z B TRANSIT hat die Anforderung zum Aufbau einer Conversation zum LU6 2 Partner abgelehnt weil der angeforderte Sync Level amp SYNCLEVEL SYNCPT 2 oder CONFIRM 1 nicht m glich ist Wenn der LU6 2 Partner den angegebenen Sync Level unterst tzt gen gt es bei TRANSIT f r die lokale LU den Generierungsparameter PAIR_EXT in der TRANSIT Konfigurierung entsprechend anzupassen amp TPNAME ist in diesem Fall z B der CICS Transakti onscode Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber vom Partner
45. wird zus tzlich die Meldung P012 ausgegeben Die Inserts haben folgende Bedeutung amp XPFUNC Name der OSS Funktion amp XPRET siehe Tabelle auf Seite 334 amp XPERR siehe Tabelle auf Seite 334 amp XPIINFO OSS Zusatzinformation amp XP2INFO OSS Zusatzinformation P002 Fehler beim Assoziationsaufbau amp XPFUNC amp ACPNT amp OSLPAP amp XPRET amp XPERR amp XP1INFO amp XP2INFO Diese Meldung wird ausgegeben wenn der Aufruf einer OSS Funktion amp XPFUNC die zum Aufbau einer Association ben tigt wird einen Fehler liefert Handelt es sich um einen vom Transportsystem gemeldeten Fehler wird zus tzlich die Meldung P012 ausgegeben Ist es kein vom Transportsystem gemeldeter Feh ler wird die Anwendung mit Termapplication beendet Die Inserts haben folgende Bedeutung amp XPFUNC Name der OSS Funktion amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPRET siehe Tabelle auf Seite 334 316 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers P003 P004 P005 amp XPERR siehe Tabelle auf Seite 334 amp XPIINFO OSS Zustatzinformation amp XP2INFO OSS Zustatzinformation Assoziation abgelehnt a_assin amp ACPNT Grund amp XPRJCT Laenge amp XPLTH Diese Meldung wird ausgegeben wenn der Aufbau einer Association von auBen abgelehnt wird Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen AC
46. 0 USY_STA E_TIMEOUT 15 DLE_STA B_LINK OCAL_SA AX_RETR UTSTAND UT_LINK OLL_TIM OOL_SIZ EJECT_R E_TIMEOUT 30 _ACT_LIM 128 P 04 Y 10 ING_TRANSMITS 16 _ACT_LIM 127 EOUT 8000 E 32 ESPONSE_TIMEOUT 10 EST_RET X X LINK_STATIO EST_RET OT_LINK ID_RETR ID_RETR N RY_INTERVAL 8 RY_LIMIT 5 _ACT_LIM 255 Y_INTERVAL 8 Y_LIMIT 5 LS_NAME PO2CGE ACTIVA E_AT_S ACTIVA DJACE DJACE ON_DE NT_BRAN NT_NODE UTO_A PG P_ FAUL LAY PE TE MITA I IT IT U DD gt DO A A REIT CTIVATE RANCH_EXTEND SESS_SU T_NN_SE APPLICA ENT_LU_ ENT_LU_ DDRESS E_REMOT ERVICES ACENT_C TARTUP 1 LAY_TIMER 1 CH_EXTENDER_NODE PROHIBITED _TYPE SUBAREA_LEN SUPPORT 0 R_LINK 0 PORT 0 VER 0 ION_RETRIES OMPRESSION 0 CRYPTION OPTIONAL 0003745000104 _ACT 0 ONE _NAME DESNIOOO M88 RROR 0 DwuMi J 1 mo m u il m ETRY_PARMS 1 R R MER 0 R _ROLE USE_ADAPTER_DEFAULTS _ATTEMPTS 1 17 18 10 43 94 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren MAX_IFRM_RCVD 0 MAX_SE D_BTU_SIZE NODE_1D 0172000E PORT_NAME LANO_04 RETRY_LINK_ON_DISC RETRY_LINK_ON_FAIL 1033 ONNECT 1 ED_START 1 RETRY_LINK_ON_FAIL REVERSE_ADDRESS_BY SOLICIT_SSCP_SESSION 0 TG_NUMBER 0 DLUR_ D D
47. 1 8 Zeichen langer Name der Stellvertreter LU Dieser Name muss mit dem in VTAM definierten LU Namen und dem in der LU6 2 Basis Software definierten Na men bereinstimmen Im Falle von TRANSIT als LU6 2 Basis Software ist dies der zweite Teil des bei XLU NETNAME vergebenen Namens Abh ngig vom verwen deten SNA Protokoll kann die Definition von LU Namen in VTAM eventuell entfal len ACCESSMETHOD VTAM Zugriffsmethode VTAM PROTOCOL APPC Es wird eine LU6 2 Verbindung definiert SINGLESESS NO Es werden parallele Sessions zugelassen openUTM LU62 ben tigt parallele Sessions DATASTREAM USER Die Benutzerdaten werden vollst ndig vom Anwendungsprogramm definiert 76 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren RECORDFORMAT U Die Benutzerdaten werden als Chain von RUs gesendet AUTOCONNECT NO I YES ALL Bei Angabe von YES oder ALL werden die Sessions beim Start von CICS aufge baut Bei NO unterbleibt dies INSERVICE YES Die Connection ist verf gbar ATTACHSEC LOCAL IDENTIFY VERIFY MIXIDPE Bei Angabe von LOCAL Standardwert darf die UTM Anwendung keine Benutzer kennung und kein Passwort beim APRO angeben KCSECTYP N Bei Angabe von IDENTIFY muss die UTM Anwendung beim APRO KCSECTYP S angeben Bei Angabe von VERIFY muss die UTM Anwendung beim APRO KCSECTYP P und eine Benutzerkennung und ein Passwort angeben Bei Angabe von MIXIDPE kann die UTM Anwendung w hlen zwi
48. 10 11 Bei Verwendung der LU6 1 Kopplung mit TRANSIT die Diagnosedateien opt lib transit PROT prot nukleus opt lib transit PROT prot utmgwl Die Meldungen sind in den TRANSIT Handb chern beschrieben Das JES Job Log mit den Konsolmeldungen von CICS oder IMS Siehe hierzu die ent sprechenden CICS bzw IMS Handb cher Der BCAM Trace von open UTM der SNA Trace von TRANSIT SERVER oder der ent sprechende Trace von SNAP IX bzw des IBM Communications Server Das Vorgehen zum Erstellen eines SNA Trace ist im Handbuch TRANSIT SERVER sowie in der Do kumentation zu SNAP IX und IBM Communications Server beschrieben Um diese Tra ces lesen zu k nnen sind Grundkenntnisse ber SNA Protokolle und bei LU6 2 Grund kenntnisse ber OSI TP Protokolle erforderlich Bei einer LU6 1 Kopplung kann es vor kommen dass openUTM im Fehlerfall eine negative Response oder einen Function Management Header 7 FMH7 sendet Beide enthalten ein 4 Byte langes Feld mit einer verschl sselten Fehlerinformation den sogenannten Sense Data Die von openUTM gesendeten Sense Data sind ab Seite 259 beschrieben Bei Verwendung von openUTM LU62 der auf Seite 66 beschriebene Protokolltrace Die von openUTM LU62 angelegten Diagnosedateien im Dateiverzeichnis opt lib utmlu62 PROT UNIX Systeme bzw Programme utm1u62 PROT Win dows Systeme werden beim Neustart einer Instanz von openUTM LU62 teilweise gel scht Sichern Sie also die Diagnosedateien rechtzeitig B
49. 263 10 1 Meldungen des Programms u62_tp 2 0222 eee eee ee 264 10 2 Meldungen des XAP TP Providers 6 eee eee es 316 10 2 1 Allgemeine Inserts der XAP TP Meldungen aaau aa aa 334 10 3 Meldungen der Dienstprogramme 6 20220 eee eee eee 343 10 3 1 Meldungen von uG2 start 2 226 pee RE RE Re aa aaa 343 10 3 2 Meldungen von U62 Sta s kk 2 aaa aa Re ed a Ba ei 349 10 3 3 Meldungen von U62 ad lt e ea c eo HR a ana nn 351 10 3 4 Meldungen von UG2 Gen s gt 4 ssr esde ROR RL EHE ES 355 U5461 J Z135 6 Inhalt Fachworter a2 ass ee HH Hee rowa BEREIT 359 Abk rzungen 2 4 ee 373 ENOR o sag agra a eae gh ee nee Oe ee 377 SUCHWOHER io 0000 2 wa a hs a ae ee a an 395 U5461 J Z135 6 Inhalt U5461 J Z135 6 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 lierbare Anwendungen gleichzeitig soll die Transaktionssicherheit f r Prozesse und Daten gew hrleistet bleiben obwohl die Gesch ftsprozesse immer komplexer werden Die wach se
50. 4 1 2 FTAN Banerlarung 22 52 4 tis ca be bee DRS a a a GH ESSE ORS 80 4 1 3 TRANSIT Generierung fiir openUTM CICS SessioNS ehe 80 4 1 4 SNAP IX Generierung f r openUTM CICS Sessions aoaaa a 80 4 1 5 Generierung des IBM Communications Server f r openUTM CICS Sessions 80 4 1 6 openUTM LU62 Generierung 2 2 222m nn nn 80 4 1 7 TNSX Generierung aaaea a 81 4 1 8 openUTM Generierung 2 2 65 a 2 za a 0 a a a a an a a aA nn a 81 4 1 9 Definieren von ClCS Transaktionen 2 2 Ho mn 81 U5461 J Z135 6 Inhalt 4 1 10 4 1 11 4 2 4 2 1 4 2 2 4 2 3 4 2 4 4 2 5 4 2 6 4 2 7 Verwendung von Benutzerkennungen 2 00 eee a 82 Vollst ndiges Generierungsbeispiel 0000 eee ee ee 83 openUTM CICS Kopplung programmieren 22 25 5s 108 CICS Kommandos f r CICS Auftraggeber Vorg nge 109 ALLOCATE 2 4 280 064 ed Be RR ee Ae A 109 CONNECT PROCESS 0 0 0 20 0 0 0 0 0 amp MOR Bw Bu Ren 6m Ge eS 110 SERIE ogad we ae ee me ae er re a 111 EEE ae ee era aber 112 CONVERSE aeaoe ao we Rk re em Ar re ee ee 112 SSVE ABEND orero 0 80 0 2 we da aa DA aa nen 113 ISSUE CONFIRMATION 3 3 2 u 2 68 me RR ei SSS Bi e EE A 113 DOE FRRO es ee OOS Oo He ee rate 113 SYNGPOINT se scp 2 08 edo ok he Bhd de RR ee ae eM 114 SY NCPOINT ROLLBACK 4 4545 6 86 45 4 0a a aaa Beh wom ERS 114 Soe PREPARE 2 2 a ak S ae Bib oO ee a og 114 FREE Bee oO tee eee eee ansehe Tek Se 115 WAIT CON
51. ABORT REC RESPONSE PEND RS vom UTM Anwendungs programm SYNC EVENT RESPONSE INVALID LENGTH INVALID TAC Ung ltiger oder gesperrter Transaktionscode INVALID FM HEADER Eine Nachricht mit FMH wurde empfangen aber der FMH ist nicht vollst ndig in der Nachricht enthalten SEQENCE NUMBER ERROR CHAINING ERROR BRACKET ERROR DIRECTION ERROR DATA TRAFFIC RESET DATA TRAFFIC NOT RESET NO BEGIN BRACKET SESSION CONTROL PROTOCOL VIOLATION IMMEDIATE REQUEST MODE ERROR QUEUED RESPONSE ERROR ERP SYNC EVENT ERROR RESPONSE OWED BEFORE SENDING REQUEST INVALID SC OR NC RH BB NOT ALLOWED CEB OR EB NOT ALLOWED EXCEPTION RESPONSE NOT ALLOWED 260 U5461 J Z135 6 Fehlerdiagnose LU6 1 Sense Data 4007 0000 4009 0000 400A 0000 400B 0000 400C 0000 400D 0000 400F 0000 4010 0000 4011 0000 4012 0000 4013 0000 4014 0000 4015 0000 4016 0000 4017 0000 DEFINITE RESPONSE NOT ALLOWED CD NOT ALLOWED NO RESPONSE NOT ALLOWED CHAINING NOT SUPPORTED BRACKETS NOT SUPPORTED CD NOT SUPPORTED INCORRECT USE OF FORMAT INDICATOR ALTERNATE CODE NOT SUPPORTED RU CATEGORY NOT CORRECT REQUEST COED NOT CORRECT SDI RTI NOT CORRECT DR1V DR2VERI NOT CORRECT QRI NOT CORRECT EDI NOT CORRECT PDI NOT CORRECT U5461 J Z135 6 261 262 U5461 J Z135 6 10 Meldungen von openUTM LU62 Dieses Kapitel enth lt alle Meldungen des Produktes openUTM LU62 sowie deren Bedeu tung und eventuell durchzuf hrende Ma nahmen
52. ASN invalid value in data struct ACSE call ASN invalid value in data struct 336 U5461 J Z135 6 Meldungen von openUTM LU62 Insert XPRJCT XPERR Bedeutung 253 Presentation call ASN invalid object id in data struct ACSE call ASN invalid object id in data struct 254 Presentation call ASN invalid length in data struct ACSE call ASN invalid length in data struct 255 Presentation call ASN invalid index in data struct ACSE call ASN invalid index in data struct 256 Presentation call ASN invalid tag in syntax table ACSE call ASN invalid tag in syntax table 300 Presentation call invalid protocol state ACSE call invalid protocol state Local function call error on system call 301 Presentation call protocol error ACSE call protocol error Local function call error on transport system call 302 Local function call error on local function call 305 Local function call error on session call 306 Local function call error on presentation call 307 Local function call error on ACSE call XPRJCT Bedeutung 0 NO_REJECT 1 APPLICATION_CONTEXT_NAME_TOO_LONG Der vom Partner empfangene Objektbezeichner der den Application Context Name bildet enth lt mehr Elemente als von openUTM unterst tzt 2 CALLING_APT_TOO_LONG Bei der Association Indication wird f r den Application Process Title eine L nge an gegeben die openUTM nicht unterst tzt 3 CA
53. Administrationsprogrammen openUTM Meldungen Test und Diagnose in BS2000 OSD Benutzerhandbuch Zielgruppe Anwender Administratoren und Programmierer von UTM Anwendungen openUTM Meldungen Test und Diagnose in UNIX und Windows Systemen Benutzerhandbuch Zielgruppe Anwender Administratoren und Programmierer von UTM Anwendungen openUTM BS2000 OSD UNIX Systeme Windows NT Anwendungen erstellen mit X Open Schnittstellen Basishandbuch Zielgruppe Programmierer die f r die Programmierung von UTM Anwendungen die X Open Schnhitt stellen CPI C XATMI und TX nutzen wollen 378 U5461 J Z135 6 Literatur openUTM openUTM Data Marshalling mit XML Online Beschreibung im Internet verf gbar Zielgruppe Programmierer von UTM Anwendungen openUTM Client UNIX Systeme f r Tr gersystem OpenCPIC Client Server Kommunikation mit openUTM Benutzerhandbuch Zielgruppe Organisatoren Einsatzplaner Programmierer von CPI C und XATMI Programmen openUTM Client f r Tr gersystem UPIC Client Server Kommunikation mit openUTM Benutzerhandbuch Zielgruppe Organisatoren Einsatzplaner Programmierer von CPI C und XATMI Programmen openUTM WinAdmin Grafischer Administrationsarbeitsplatz f r openUTM Online Beschreibung im Internet verf gbar und Online Hilfe Zielgruppe Organisatoren und Administratoren von UTM Anwendungen openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Assembler Erganzung zum Basishandb
54. Auftraggeber Der Alias Name amp ALIAS der Partner LU stimmt nicht mit dem konfigurierten Namen amp CONFALIAS ueberein Es liegt ein Namensproblem in der Konfigurierung vor Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Keine Unterstuetzung von Service TPs auf mapped Conversations Der LU6 2 Partner hat versucht eine Conversation mit einem nicht abdruckbaren TP Namen d h Transaktionscode zwischen X 00 und X 3F zu starten open UTM LU62 unterst tzt au er dem Resync TP X 06F2 keine derartigen sogenannte Ser vice TPs Diese Meldung erscheint beispielsweise bei der Verwendung der Funkti on EXEC CICS START die in openUTM LU62 das Service TP X 02 anspricht Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Konfigurationsfehler Der Netzname der lokalen und oder der fernen LU ist umkon figuriert worden Eine vom LU6 2 Partner ankommende Conversation zum TP amp TPNAME wird abge lehnt weil bei der berpr fung der Netzwerknamen der lokalen und der fernen LU eine Inkonsistenz festgestellt wurde Dies bedeutet dass sich hinter den Alias Na men der lokalen und oder der fernen LU z B in der TRANSIT Konfigurierung nicht mehr dieselben LUs im SNA Netz verbergen wie zu einem fr heren Zeitpunkt Dieser Meldung geht stets mindestens eine der Meldungen 042 und 044 voraus 284 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Prog
55. CMX PCMX bzw BCAM SNA Basis Software z B VTAM Windows System PCMX openUTM LU62 IBM Communications Server Enterprise Extender SNA Uber IP LU6 2 Kopplung Uber Gateway Rechner mit IBM Communications Server auf Windows Systemen Im Falle von openUTM unter BS2000 OSD ist zus tzlich das Produkt OSS BS2000 OSD erforderlich Die Verbindung zwischen den beiden linken Rechnern erfolgt Uber TCP IP mit RFC1006 Im Bild ist eine SNA Kopplung Uber Enterprise Extender SNA uber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu IBM Communications Server 32 U5461 J Z135 6 Kopplung mit IBM Systemen Direkte LU6 1 Kopplung mit openUTM ber TRANSIT auf Solaris 2 9 Direkte LU6 1 Kopplung mit openUTM ber TRANSIT auf Solaris Die folgende Kopplungsm glichkeit kann eingesetzt werden wenn die UTM Anwendung auf einem Solaris Rechner l uft der direkt an ein SNA Netz angebunden ist Solaris Rechner openUTM CMX TRANSIT CLIENT mit UTMGW1 TRANSIT SERVER IBM Rechner CICS oder IMS SNA Basis Software z B VTAM SNA ber Ethernet LU6 1 Kopplung ber TRANSIT mit openUTM auf Solaris Im Bild ist eine SNA Kopplung ber Ethernet dargestellt Zu anderen Kopplungsm glichkei ten siehe das Handbuch TRANSIT SERVER U5461 J Z135 6 33 LU6 1 Kopplung ber Gateway mit TRA
56. CONVID SYNCLEVEL 2 SEND LAST CONVID ISSUE PREPARE CONVID FMH5 Datent Prepare gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P PEND ER FR lt FMH7 FMH7 Response gt TERMERR SEND Client eee RETURN U5461 J Z135 6 127 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 6 PEND RS im UTM Anwendungsprogramm gt SYNCPO SEND Cl Zone gt lt RETURN RECEIVE Client ALLOCAT CONNECT PROCESS CONVID SYNCLEVEL 2 SEND CONVID E NT NORMAL jent RECEIVE Client SEND LAST CONVID SYNCPOINT ROLLEDBACK SEND Client RECEIVE Client SEND LAST CONVID SYNCPOINT NORMAL SEND Client FMH5 Daten RequestCommit gt Committed Daten RequestCommit gt FMH7 FMH7 Response gt Daten RequestCommit gt Committed INIT PU ENDTA F SEND N MGE PEND RE INIT PU MGET PEND RS INIT PU ENDI MGET NT KCRN lt MGET PEND FI VGST 0 TAST P ENDTA F SEND N VGST 0 TAST P MPUT RM KCRN lt VGS1 A F SEND N 0 TAST P 128 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren Ein PEND RS im UTM Anwendungsprogramm verh lt sich jedoch nur dann so wie im Bei spiel beschrieben wenn der Vorgang schon vorher einen Sicherungspunkt erreicht hat Ein PEND RS im ersten Dia
57. D D LOCAL_LU oO MODE EFAULTS EFAULT_PU_NAME PO LUS_RETRY_LIMIT 3 LUS_RETRY_TIMEOUT LU_NAME TO2CGEI4 PORT_NAME LANO_04 EFAULT_POOL 0 LU_ALIAS T02CGEI4 LU_SESSION_LIMIT 1 NAU_ADDRESS 0 ROUTE_TO_CLIENT 0 SYNCPT_SUPPORT MODE_NAME MODDIS89 AUTO_ACT 5 COMPRESS_IN_SERIES 0 COMPRESS ION PROHIBITED COS_NAME CONNECT ENCRYPT AX_OUT AX_RU DEFAULT AX_INCOMING_COMPR AX_NEGOTIABLE_SES ION_SUPPORT _RU_SIZE 1 TGOING_COMPR SIZE_UPPER IN_CONWINNERS_SOU PLU_MODE_SESSION_L RECEIVE_PACING WIN URE 1 TES 0 USE_DEFAULT_TG_CHARS 1 USE_PU_NAME_IN_XID 0 2CGE 5 00 NONE ESSTON_LEVEL NONE SION_LIMIT 128 ESSTON_LEVEL NONE BOUND 4096 RCE 5 IMIT 15 DOW 1 13 11 12 16 17 4 16 19 6 5 7 6 U5461 J Z135 6 95 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 MODE MODE_NAME SNASVCMG AUTO_ACT 0 COMPRESS_IN_SERIES 0 COMPRESSION PROHIBITED COS_NAME SNASVCMG ENCRYPTION_SUPPORT NONE DEFAULT_RU_SIZE 0 MAX_INCOMING_COMPRESSION_LEVEL NONE MAX_NEGOTIABLE_SESSION_LIMIT 2 MAX_OUTGOING_COMPRESSION_LEVEL NONE MAX_RU_SIZE_UPPER_BOUND 512 MIN_CONWINNERS_SOURCE 1 PLU_MODE_SESSION_LIMIT 2 RECEIVE_PACING_WINDOW 1 PARTNER_LU FQ_PLU_NAME DESNIO000 A9CICST6 ADJACENT_CP_NAME DESNIO00 M88 CONV_SECURITY_VERIFICATION 1 MAX_MC_LL_SEND
58. Daten gt MGET NT VGST 0 KCRN A MPUT NE KCRN A PEND KP lt Daten GU IOPCB ISRT IOPCB Exit Daten CEB gt MGET NT VGST C KCRN A U5461 J Z135 6 199 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 In diesem Beispiel sind nur die IMS DL I Aufrufe zum Senden und Empfangen von Nachrichten aufgef hrt Um Daten ber mehrere Dialgoschritte hinweg verf gbar zu halten arbeiten IMS DL I Programme typischerweise mit einer Scratchpad Area Zum Lesen und Schreiben der Scratchpad Area sind weitere GU GN oder ISRT Aufrufe erforderlich 5 Synchroner Aufruf einer IMS Transaktion von openUTM mit Transaktionssicherung erste Variante IMS Anwendung UTM Anwendung APRO DM KCOF C KCPI gt A MPUT NE KCRN A PEND KP lt FMH5 Daten GU IOPCB ISRT IOPCB Daten RQD2 gt Systemcode lt DR2 MGET NT VGST 0 KCRN A PEND FI lt Prepare Req Commit gt lt Committed Forget CEB gt 200 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren 6 Synchroner Aufruf einer IMS Transaktion von openUTM mit Transaktionssicherung zweite Variante IMS Anwendung UTM Anwendung APRO DM KCOF C KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten GU IOPCB ISRT IOPCB Daten RQD2 gt Systemcode lt DR2 MGET NT VGST 0 KCRN A MPUT NE KCLM 0 KCRN A CTRL PE PEND KP lt Prepare Req Commit gt MGET NT VGST
59. ESA Installation Volume 2 System Definition and Tailoring zu entnehmen SESSION n n bestimmt die Anzahl der parallelen Sessions eines Nodes F r openUTM unter UNIX Systemen sind keine parallelen Sessions m glich n 1 Makro VTAMPOOL Dieser Makro muss angegeben werden wenn mit parallelen Sessions gearbeitet werden soll Er steht am Beginn der Definition eines oder mehrerer LU6 Subpools Diese werden ber SUBPOOL Makros definiert von denen wiederum jeder von einem oder mehreren NAME Makros gefolgt werden kann VTAMPOOL Der Makro hat keine Operanden Makro SUBPOOL Mit diesem Makro wird ein LU6 Subpool definiert F r jede Session die dynamisch aufge baut werden soll wird ein SUBPOOL Makro ben tigt SUBPOOL NAME subpool name MSGDEL SYSINFO Die Operanden haben folgende Bedeutung NAME subpool name subpool name korrespondiert mit dem RSES Operanden der zugeh rigen LSES Anweisung in der UTM Generierung MSGDEL SYSINFO Der Parameter muss identisch dem MSGDEL Operanden des TERMINAL Makros gew hlt werden 240 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 1 IMS Generierung f r openUTM IMS Sessions Makro NAME Mit diesem Makro wird zu einem physikalischen Terminal ein logischer Terminalname defi niert Mit diesem Namen wird im IMS Programm die UTM Session adressiert Durch Angabe des NAME Makros nach dem SUBPOOL Makro wird bestimmt dass das logische Terminal dynamisch angelegt werden soll Dies ist e
60. Funktion UserDataln Der Makro mGetBufferSpace lieferte den Returncode LB_NOMEM SND007 XM Modul KCOXFSD Funktion ap_snd Der Returncode der Funktion GetVarLthAttr war ungleich GA_OK XADM12 AX Modul KCOXFEX Funktion apext_adm Die Funktion apext_adm wurde in der multitasking Variante mit einem unbekannten Opcode aufgerufen XATT04 XM Modul KCOXFEX Funktion apext_att Der Returncode der Funktion EstablishBuffer war ungleich LB_OK XATT12 XM Modul KCOXFEX Funktion apext_att Der Returncode der Funktion EstablishBuffer war ungleich LB_OK XATT13 XM Modul KCOXFEX Funktion apext_att Der Returncode der Funktion RequestBuffer war ungleich LB_OK XFAU03 XA Modul KCOXFHF Funktion AllocUserMem Der Parameter lt Type gt enthielt einen ung ltigen Wert XFDUO2 XA Modul KCOXFHF Funktion DeallocUserMem Der Parameter lt Type gt enthielt einen ung ltigen Wert XFGA07 XSA Modul KCOXFHF Funktion GetAttribute Beim Lesen des Attributs AP_DTNID in der singletasking Variante lie ferte die Funktion AllocUserMem einen unerwarteten Returncode XFGA11 Modul KCOXFHF Funktion GetAttribute Der Makro mGetBufferSpace lieferte den Returncode LB_NOMEM XFGEO2 AX Modul KCOXFHF Funktion bCheckAndGetCallEnv Die Funktion bCheckAndSetState lieferte einen schlechten Return code und der Anwendungsstatus war ungleich WAITI
61. IBM Communications Server in der Definition der lokalen LU angegeben werden In TRANSIT muss an dieser Stelle auch noch die Netzidentifikation ange geben werden Wird SNAP IX oder der IBM Communications Server verwendet und soll mit Transaktionssicherung gearbeitet werden so muss in SNAP IX bzw im IBM Communications Server bei der Definition der lokalen LU Syncpoint Support generiert werden Bei Verwendung von Enterprise Extender entf llt die Definition des LU Namens in VTAM Zwischen VTAM CICS und dem System auf dem openUTM LU62 l uft muss ein Mode Name vereinbart werden Dieser Mode Name muss in VTAM in der Connec tion Definition von CICS in der XMODE und XLU Anweisung von TRANSIT bzw in der MODE Definition von SNAP IX bzw des IBM Communications Server und in der openUTM LU62 Generierung angegeben werden Es muss festgelegt werden wieviele LU6 2 Sessions zwischen CICS und openUTM LU62 und wieviele parallele Verbindungen zwischen openUTM LU62 und der UTM Anwendung maximal aufgebaut werden d rfen Diese beiden Werte sollten identisch gew hlt werden um Stausituationen zu vermeiden Die Maximal zahl der Sessions muss eingetragen werden bei der Session Definition in CICS und bei der XMODE Anweisung in TRANSIT bzw bei der MODE Definition von SNAP IX bzw des IBM Communications Server Die Maximalzahl der parallelen Verbindungen muss in der open UTM LU62 Generierung und der openUTM Gene rierung jeweils mit dem Parameter ASSOCIATIONS
62. INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI lt FMH5 Daten Prepare RequestCommi t Committed Forget Daten Prepare RequestCommi t Committed Forget CMACCP CMRCV gt CM_TAKE_COMMIT_SEND SRRCMIT RR_OK CMSEND gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT U5461 J Z135 6 165 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 Wenn beim zweiten Prepare keine Daten gesendet werden k nnen analog zu den Beispie len 12 und 13 die folgenden UTM Aufrufe entfallen PUT NE KCRN gt A CTRL PE KCRN gt A PEND KP INIT GET NT KCRN gt A VGST C TAST P 16 Zwei Transaktionen in einem Vorgang zweite Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A KCLM 0 CTRL PR KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST P MPUT NE Client PEND RE FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED CMSEND Daten Prepare gt CMRCV gt CM_TAKE_COMMIT SRRCMIT RequestCommit Committed gt Forget RR_OK Fortsetzung n chste Seite 166 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C Fortsetzung INIT MGET Client MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP
63. J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp REASON Grp Ursache ASA003 XA Der Modul KCOASAM wurde mit dem Operationscode ASAM_SET_ACCPTS aufgerufen Schlechter Returncode von BerSetAet ASA004 XA Der Modul KCOASAM wurde mit dem Operationscode ASAM_SET_ PARTNER aufgerufen Schlechter Returncode von BerSetAet ASA006 ASX Der Modul KCOASAM wurde mit dem Operationscode ASAM_ATTACH aufgerufen Schlechter Returncode von bBuildPAddr ASA007 ASX Der Modul KCOASAM wurde mit dem Operationscode ASAM_ATTACH aufgerufen OSS gibt Returncode NOTFIRST Vermutlich ist die Instanz bereits gestartet ASA104 AX Die Funktion bBuildPAddr des Moduls KCOASAM wurde aufgerufen Der Presentation Selector eines lokalen Accesspoints oder eines fer nen Partners ist zu lang ASA105 AX Die Funktion bBuildPAddr des Moduls KCOASAM wurde aufgerufen Der Session Selector eines lokalen Accesspoints oder eines fernen Partners ist zu lang ASA106 AX Die Funktion AssociationRequest des Moduls KCOASAM wurde auf gerufen OSS liefert beim assrq Aufruf den Returncode ERROR ASA107 AX Die Funktion AssociationRequest des Moduls KCOASAM wurde auf gerufen OSS liefert beim assrq Aufruf den Returncode INVREF ASA108 AX Die Funktion AssociationRequest des Moduls KCOASAM wurde auf gerufen OSS liefert beim assrq Aufruf einen schlechten Returncode ASA123 A Der Modul KCOASAM wurde mit dem Operat
64. KCENDTA und Senderecht KCSEND pr fen kann Wenn es aufgrund der Ablauflogik nicht notwendig ist diese Werte abzufragen kann auch der normale INIT verwendet werden Beim MGET wurden die Anzeigen KCVGST Vorgangsstatus und KCTAST Transaktionsstatus mit VGST bzw TAST abgek rzt Das SYNCPOINT Kommando im CICS Anwendungsprogramm kehrt erst zur ck nachdem das UTM Anwendungsprogramm PEND FI aufgerufen hat Dies ist dargestellt durch die Zeile NORMAL U5461 J Z135 6 123 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 RequestCommit und Committed sind Bestandteile des LU6 2 Protokolls Wenn das CICS Anwendungsprogramm mehr als einen Auftragnehmer hat so benutzt es teilweise ein zweiphasiges Protokoll mit den Protokollelementen Prepare RequestCommit Committed Forget Im CICS Anwendungsprogramm kann vor dem SYNCPOINT noch das Kommando ISSUE PREPARE aufgerufen werden Dieses hat bei einem PEND ER FR im UTM Anwendungs programm gewisse Vorteile Siehe hierzu weiter unten 2 Keine Daten vom UTM Anwendungsprogramm im CICS Anwendungsprogramm ben tigt und mit Transaktionssicherung Wenn es von der Ablauflogik her nicht erforderlich ist dass das aufgerufene UTM Anwen dungsprogramm dem CICS Anwendungsprogramm Daten zur cksendet so kann die Kom munikation wie im folgenden Beispiel einfacher programmiert werden gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2
65. LU62 Meldungen des Programms u62_tp 316 320 321 322 Ankommende Conversation fuer TP amp TPNAME nicht mehr vorhanden Vermutlich bei einer Kollision von RECEIVE_ALLOCATE mit TP_ENDED verse hentlich abgebaut Ein tempor rer Fehler in der LU6 2 Basis Software f hrte zum Abbruch einer vom LU6 2 Partner ankommenden Conversation amp TPNAME bezeichnet den UTM Transaktionscode Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Allokationsfehler Code amp ERRTXT Im Moment l sst sich keine Conversation zum TP amp TPNAME des LU6 2 Partners aktiv aufbauen amp TPNAME ist in diesem Fall z B der CICS Transaktionscode Der Fehlercode amp ERRTXT enth lt dann im Klartext den Returncode des entsprechen den LU6 2 Aufrufs Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Inkonsistenz in den Konfigurationen von openUTM LU62 und der LU6 2 Basis Software MODENAME LOC_LU_ALIAS REM_LU_ALIAS Mit den aktuellen Generierungen der LU6 2 Basis Software z B TRANSIT und openUTM LU62 lassen sich grunds tzlich keine Conversations zum LU6 2 Partner aufbauen weil der Alias Name der lokalen oder der fernen LU oder der Name des Modes nicht in der Konfiguration der LU6 2 Basis Software enthalten ist Diese Si tuation bleibt solange bestehen bis die LU6 2 Basis Software oder die openUTM LU62 Instanz gestoppt
66. LU62 generieren LU6 2 Kopplungen mit openUTM LU62 LU62 CODE Beschreibung des Zeichensatzes in dem die Benutzerdaten der LU6 2 Anwen dungsprogramme codiert sind ASCII Die LU6 2 Anwendungsprogramme verwenden den ASCII 8 Bit Zeichensatz ISO 8859 1 Dies ist blich f r Anwendungsprogram me auf UNIX Windows oder OS 2 Systemen EBCDIC 500 Die LU6 2 Anwendungsprogramme verwenden IBM EBCDIC mit Code Page 500 Dies ist die bei IBM auf Gro rechnern oder AS 400 bliche internationale Code Page sowie die nationale Code Page f r Belgien und die Schweiz EBCDIC 273 Die LU6 2 Anwendungsprogramme verwenden IBM EBCDIC mit Code Page 273 Dies ist die bei IBM auf Gro rechnern oder AS 400 bliche nationale Code Page f r Deutschland und sterreich EBCDIC 037 Die LU6 2 Anwendungsprogramme verwenden IBM EBCDIC mit Code Page 037 Dies ist die bei IBM auf Gro rechnern oder AS 400 bliche nationale Code Page f r USA Kanada Niederlande und Portugal NO openUTM LU62 f hrt keine Code Konvertierung der Benutzerdaten durch Dieser Wert muss angegeben werden wenn die Anwen dungsprogramme Bin rdaten also z B binare Langenfelder ber tragen Standardwert openUTM LU62 f hrt eine Codekonvertierung aller Benutzerdaten durch wenn bei LU62 CODE und OSITP CODE unterschiedliche Zeichens tze generiert sind Bei NO f hrt open UTM LU62 keine Codekonvertierung durch Ist hier NO angege ben so muss auch bei OSITP CODE NO angegeben wer
67. Linux bzw AlX Systemen und Einsatz des IBM Communcations Server Im Bild ist eine SNA Kopplung Uber Enterprise Extender SNA Uber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu IBM Communications Server U5461 J Z135 6 27 Direkte LU6 2 Kopplung ber IBM Communications Server Kopplung mit IBM Systemen 2 4 Direkte LU6 2 Kopplung ber IBM Communications Server auf Windows Systemen Die folgende Kopplungsm glichkeit kann eingesetzt werden wenn die UTM Anwendung auf einem Windows System l uft das direkt an das SNA Netz angebunden ist Windows System IBM Rechner CICS oder IMS openUTM oder TXSeries PCMX SNA Basis Software openUTM LU62 z B VTAM IBM Communications Server Enterprise Extender SNA ber IP Direkte LU6 2 Kopplung mit openUTM auf Windows Systemen und Einsatz des IBM Communcations Server Im Bild ist eine SNA Kopplung ber Enterprise Extender SNA ber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu IBM Communications Server 28 U5461 J Z135 6 Kopplung mit IBM Systemen LU6 2 Kopplung ber Gateway mit TRANSIT auf Solaris 2 5 LU6 2 Kopplung ber Gateway Rechner mit TRANSIT auf Solaris Die folgende Kopplungsm glichkeit ber LU6 2 kann immer dann eingesetzt werden wenn der Rechner auf dem die UTM Anwendung l uft nicht direkt an das SNA Netz angebun den w
68. PIPEFILE errno amp ERRNO amp ERRTEXT Instanz amp INST Fehler beim Oeffnen der Output Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT Vermutlich handelt es sich um einen tempor ren Mangel an Systemressourcen Instanz amp INST Instanz befindet sich noch in der Initialisierungsphase oder bereits in der Endebehandlung Instanz amp INST Fehler beim Schreiben in die Output Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT Diese Meldung sollte nur in Ausnahmesituationen erscheinen etwa bei einem Man gel an Systemressourcen oder bei einer Kollision mit der Beendigung der openUTM LU62 Instanz amp INST Instanz amp INST Fehler beim Schreiben in die Output Pipe amp PIPEFILE Anzahl geschriebener Bytes fehlerhaft Instanz amp INST Instanz amp PID amp PID reagiert nicht in angemessener Zeit Nachdem u62_sta seine Anfrage an die Instanz INST von openUTM LU62 gestellt hat antwortet das Programm u62_tp nicht innerhalb einer fest vorgegebenen Zeit Diese maximale Wartezeit betr gt 5 Sekunden u62_sta f hrt dann mit der Status anfrage an die n chste openUTM LU62 Instanz fort Eine eventuell versp tet ein treffende Quittung von der openUTM LU62 Instanz amp INST wird stillschweigend ver worfen Solch drastische Verz gerungen k nnen durchaus bei h herer Last und gro en Konfigurationen auftreten Instanz amp INST Fehler beim Lesen aus der Input Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT U54
69. Parameter LU6 2 177 IMS Transaktionen 179 Independent LU 364 INFO siehe KDCS Aufruf INIT siehe KDCS Aufruf Initiator 364 Installationsverzeichnis openUTM LU62 39 INSTANCE Anweisung 43 Instanz 36 Instanz Trace 55 63 64 ISC Edit 238 256 ISRT Aufruf siehe IMS Aufrufe K Kaltstart 40 56 364 KCDF 234 KCDPN 251 252 253 KCMF 234 KCPRN 251 252 253 KCPSWORD 82 KCPWDTYP 82 KCRDPN 251 KCRPRN 251 KCSECTYP 82 150 KCTAST 123 KCUIDTYP 82 KCUSERID 82 KCVGST 123 KDCS Aufruf APRO AM 77 121 144 151 175 233 APRO DM 77 91 121 151 230 APRO IN 251 253 CTRLAB 122 153 CTRL PE 121 134 150 152 CTRL PR 121 137 150 152 166 INFO GN 251 252 INITPU 123 MPUT EM 122 130 153 160 MPUTHM 122 143 153 173 MPUT RM 128 158 PENDER 122 127 153 157 PEND FR 122 127 153 157 PEND RE 136 165 PEND RS 122 128 153 158 KDCS Aufrufe Vergleich mit CICS 121 230 Vergleich mit CPI C 151 Vergleich mit IMS 245 Klammern 21 Konfigurationsdatei 42 erzeugen 52 Kontrollinstanz 66 Kursivschrift 21 L Linux Systeme IBM CS Gateway f r LU6 2 Kopplung 31 LU6 2 Kopplung ber IBM CS 27 LNETNAME 239 LOC AE 46 LOC AEQ 46 LOC APT 47 LOC LISTENER PORT 47 LOC LU ALIAS 47 LOC TSEL 47 Log Name 366 Log Record 366 Logical Unit 365 Logical Unit of Work 365 LPAP Anweisung 209 238 239 LSES Anweisung 211 240 242 LTAC Anweisung 243 LTERM Definition IMS Beispiel 185 398 U5461 J Z135 6 Stichw rter LU 365 LU6 1 Ko
70. Parametern LOC APT LOC AEQ LOC_TSEL und LOC LISTENER PORT generiert werden Bei Verwendung von TNSX sind stattdessen die Parameter LOC APT LOC AEQ und LOC AE zu verwenden Verbindung von openUTM LU62 und LU6 2 Anwendung Die Verbindung zwischen openUTM LU62 und der LU6 2 Anwendung wird mit den Para metern REM LU ALIAS MODENAME ALLOC TIME und LU62 CODE definiert Verbindung zwischen openUTM LU62 und UTM Anwendung Wenn Sie die TCP IP Adress Information in der INSTANCE Anweisung generieren sind zur Generierung der Verbindung zwischen openUTM LU62 und der UTM Anwendung min destens die Parameter REM APT REM AEQ REM NSEL REM TSEL REM LISTENER PORT und CONTWIN erforderlich Bei Verwendung von TNSX sind stattdessen die Parameter REM APT REM AEQ REM AE und CONTWIN zu verwenden Mit den restlichen Parametern APPL CONTEXT ASSOCIATIONS CONNECT OSI TP CODE UTM ASYNC k nnen weitere Parameter der Verbindung zur UTM Awen dung beschrieben werden U5461 J Z135 6 43 openUTM LU62 generieren LU6 2 Kopplungen mit openUTM LU62 Syntax der INSTANCE Anweisung INSTANCE LOC LU ALIAS loc_lu_alias_name LOC LISTENER PORT loc_port J LOC TSEL T A E loc_tsel LOC AE loc_tns_name J LOC APT loc_ap_title LOC AEQ REM LU ALIAS rem_lu_alias_name loc_ae_qualifier MODENAME mode_name C ALLOC TIME alloc_ E LU62 CODE ASCII EBCDIC 500 EBCDIC 273 EBCDIC 037 xNO
71. RE SRRCMIT 3 CMRCV INIT MGET NT KCRN gt R cksetzen der Transaktion SRRBACK MPUT RM KCRN lt PEND RS INIT MGET NT KCRN lt Rucksetzen der Transaktion und Abbruch des Vorgangs SRRBACK PEND ER FR CMSDT CM_DEALLOCATE_ABEND CMDEAL Nachrichtenaustausch mit Verarbeitungsquittung CMSPTR PREP_TO_RECEIVE_CONFIRM MPUT NE KCRN gt CMSST CM_SEND_AND_PREP_TO_RECEIVE MPUT HM KCRN gt CMSEND PEND KP CMRCV s INIT MGET NT KCRN gt Senden einer Antwort mit positiver Verarbeitunsquittung CMCFMD MPUT NE CMSEND PEND FI Senden einer Antwort mit negativer Verarbeitunsquittung CMSERR MPUT EM Abbruch des Dialogs zum Partner CMSDT CM_DEALLOCATE_ABEND CTRL AB CMDEAL U5461 J Z135 6 153 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 4 3 2 Beispiele f r openUTM CPI C Kommunikation Start eines openUTM Dialogvorgangs aus einem CPI C Anwendungsprogramm 1 Einschrittvorgang mit Transaktionssicherung CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND CMRCV CM_OK CMDEAL SRRCMIT RR_OK FMH5 Daten gt INIT PU ENDT MGE VGST MPUT NE PEND KP lt Daten Daten RequestCommit gt INIT PU ENDT MGET VGST PEND FI lt Committed A 0 SEND Y 0 TAST 0 A F SEND N 0 TAST P 2 Keine Daten vom UTM Anwendungsprogramm im CPI C A
72. RECFM data area ATTACHID name definiert den Namen des ATTACH Headers Dieser Name wird beim SEND oder CONVERSE Kommando angegeben PROCESS name spezifiziert den UTM Transaktionscode des fernen Vorgangs RECFM data area data area ist ein zwei Byte langes Feld das das Satzformat der von CICS gesen deten S tze enth lt x 01 Daten im VLVB Format x 04 Daten im Format Chain of RUs Andere Optionen siehe CICS for MVS ESA Application Programming Reference dieses Kommandos sind bei der Kopplung mit openUTM ohne Bedeutung U5461 J Z135 6 221 CICS Kommandos f r CICS Auftraggeber Vorg nge openUTM CICS Kopplung ber LU6 1 SEND Dieses Kommando erstellt eine Dialogteilnachricht Das Kommando hat folgende Syntax EXEC CICS SEND LSESSION name J LATTACHID name FROM bereich LENGTH bereich INVITE SESSION name spezifiziert den Namen der Session Dieser ist als R ckgabewert aus dem ALLOCATE Kommando bekannt EIBRSRCE Die Nachricht ist in diesem Fall f r den Auftragnehmer alternate facility bestimmt Wird die Option weggelassen so ist die Nachricht f r den Auftraggeber principal facility bestimmt ATTACHID name spezifiziert den Namen der ATTACH ID wie er im BUILD ATTACH Kommando definiert wurde FROM bereich und LENGTH bereich spezifizieren die Adresse und die L nge der Nachricht Das Format muss der An gabe bei RECFM beim BUILD ATTACH entsprechen Wenn beim BUILD ATTACH VL
73. SNAP IX bzw im IBM Communications Server muss dieser CP Name ebenfalls generiert werden In TRANSIT muss kein CP Name angegeben werden 11 12 13 14 15 16 18 19 Wenn die SNA Verbindung ber Ethernet realisiert ist m ssen die Parameter IDBLK und IDNUM zwischen VTAM und TRANSIT bzw SNAP IX oder IBM Com munications Server vereinbart werden Bei Kommunikation mit SNA ber Ethernet sollte ebenfalls die maximale Frame Size zwischen VTAM und TRANSIT bzw SNAP IX oder IBM Communications Ser ver vereinbart werden Wenn die Generierungsparameter nicht bereinstimmen ei nigen sich die beiden Partner manchmal aber nicht immer auf den kleineren der beiden Werte In VTAM muss die MAC Adresse des Systems angegeben werden auf dem openUTM LU62 l uft In der Logon Mode Table von VTAM wird der Name einer Mode Tabelle verwendet Dieser Name muss bei der Mode Definition und bei der LU Definition angegeben werden Innerhalb von TRANSIT muss f r den SNA Ethernet Anschluss ein Link Name ver geben werden Der Name ist bei der XLINK und bei der XPU Anweisung anzuge ben Bei SNAP IX und beim IBM Communications Server wird stattdessen der Port Name verwendet Innerhalb von TRANSIT muss f r das Partnersystem auf dem CICS l uft ein PU Name vergeben werden Der Name ist bei der XPU und bei der XRLU Anwei sung anzugeben Man w hlt diesen Namen blicherweise identisch zum PU Na men in VTAM Bei SNAP IX und
74. Session Eigenschaf ten wie z B Maximalzahl von parallelen Sessions RU Sizes Pacing Werte Die zu einem Mode Name geh renden Eigenschaften m ssen blicherweise in min destens einem System per Generierung festgelegt werden Bei LU6 wird der Mode Name nur am Host generiert Bei LU6 2 und independent LUs m ssen die Mode Namen in allen beteiligten Systemen generiert werden Network Control Program NCP Betriebssystem des Communication Controller 366 U5461 J Z135 6 Fachw rter Netzwerkname Siehe Logical Unit Pacing Mechanismus zur Datenflusskontrolle bei SNA Beim Pacing gibt der Empf nger dem Sender immer nur die Erlaubnis eine bestimmte Anzahl von RUs zu sen den Parallele Session Wenn zwischen zwei LUs mehr als eine Session besteht so bezeichnet man diese Sessions als parallele Sessions Parallele Sessions sind bei LU6 nur m glich zwischen zwei Typ 5 Knoten bei LU6 2 nur zwischen zwei Typ 2 1 Kno ten Physical Unit PU Jeder Knoten in einem SNA Netz enth lt als adressierbare SNA Instanz eine physical unit PU Bevor zwei logical units LUs im SNA Netz eine Kommunika tionsbeziehung aufbauen k nnen muss zuerst eine Kommunikationsbezie hung zwischen den jeweiligen PUs aufgebaut werden In SNA Netzen gibt es unterschiedliche Typen von PUs Dementsprechend bezeichnet man die zugeh rigen Systeme als Typ 5 Knoten Typ 4 Knoten Typ 2 0 Knoten oder Typ 2 1 Knoten Primary Logical Unit PLU Secon
75. TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt OSI TP Seite ist Auftraggeber Lokaler TPSU Title kann nicht dekodiert werden Beim Dekodieren des in der TP_BEGIN_DIALOGUE indication enthaltenen TPSU Title d h des Transaktionscodes ist ein Fehler aufgetreten vermutlich hat der OSI TP Partner d h die UTM Anwendung den TPSU Title fehlerhaft codiert openUTM LU62 lehnt daher den OSI TP Dialogwunsch ab Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt OSI TP Seite ist Auftraggeber Typ des lokalen TPSU Title fehlerhaft Der Typ des in der TP_BEGIN_DIALOGUE indication enthaltenen TPSU Title d h des Transaktionscodes ist weder PRINTABLE_STRING noch T61_STRING Da openUTM LU62 nur diese beiden Typen unterst tzt wird der OSI TP Dialog wunsch abgelehnt U5461 J Z135 6 295 Meldungen des Programms u62_tp Meldungen von openUTM LU62 363 364 365 366 369 Ankommender Dialogwunsch abgelehnt OSI TP Seite ist Auftraggeber Die Laenge des lokalen TPSU Title LEN ueberschreitet den Maximalwert von amp MAXLEN Der in der TP_BEGIN_DIALOGUE indication enthaltene dekodierte TPSU Title d h z B der CICS Transaktionscode ist amp LEN Zeichen lang Beim Conversa tionaufbau zum LU6 2 Partner hin stehen jedoch nur amp MAXLEN Zeichen bei TRANSIT als LU6 2 Basis Software 64 Zeichen zur Verf gung openUTM LU62 lehnt d
76. Transaktion gestartet openUTM LU62 hat die Transaktion bereits festgeschrieben der LU6 2 Partner ist hier ber m glicherweise noch nicht informiert agent in doubt Der LU6 2 Partner hat die Transaktion gestartet openUTM LU62 kann die Transaktion im Moment noch vor oder zur cksetzen agent HM Der LU6 2 Partner hat die Transaktion gestartet der OSI TP Partner d h die UTM Anwendung hat einen heuristischen Mix gemeldet d h die beteiligten Datenbanken sind nicht konsistent Dies muss dem LU6 2 Partner noch mitgeteilt werden agent RIP Der LU6 2 Partner hat die Transaktion gestartet der OSI TP Partner d h die UTM Anwendung hat einen heuristischen Hazard gemeldet d h es ist nicht sicher ob die beteiligten Datenbanken konsistent sind Dies muss dem LU6 2 Partner noch mitgeteilt werden 302 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 403 RECORDS Beschreibung init spm pend Der OSI TP Partner d h die UTM Anwendung hat die Transaktion gestartet Es ist noch keine Information vom LU6 2 Partner eingetroffen ob er die Transaktion vor oder zur cksetzen will log commit openUTM LU62 hat die Transaktion bereits festgeschrieben der OSI TP Partner d h die UTM Anwendung ist hier ber m glicherweise noch nicht informiert log ready openUTM LU62 kann die Transaktion im Moment noch vor oder zur ck setzen log damage mix Der LU6 2 Partner ha
77. Typ c w k Diese Meldung wird immer beim Start einer Instanz ausgegeben Ende von openUTM LU62 u62_start gibt in die Protokolldatei einer gestarteten Instanz von open UTM LU62 eine Start und Endemeldung aus jeweils versehen mit der genauen Uhrzeit amp INSTPID in der Startmeldung 17 gibt die Prozess Id des Programms u62_tp an die die Protokollumsetzung f r die lokale LU amp LUNAME vornimmt Der aktuelle User ist nicht zum Start von openUTM LU62 berechtigt Benutzer des UNIX Systems ungleich root die nicht in der Konfigurationsdatei u62_users aufgelistet sind sind nicht zum Start von openUTM LU62 Instanzen be rechtigt Variable U62_INST_DIR Installationsverzeichnis nicht gesetzt Die Variable U62_INST_DIR wird wahrend des Installationsvorgangs in die Regi stry von Windows Systemen eingetragen und muss demnach immer gesetzt sein Ist dieser Eintrag aus der Registry gel scht bricht u62_start sofort ab UTM LU62 laeuft als Service Dieser Hinweis wird nur in die Datei stderr txt ausgegeben stdout kann nicht umgeleitet werden in amp FILENAME errno amp ERRNO amp ERRTEXT stderr kann nicht umgeleitet werden in amp FILENAME errno amp ERRNO amp ERRTEXT Wird openUTM LU62 als Service gestartet besteht keine Verbindung zu einem Ter minal an das Meldungen ausgegeben werden k nnen Daher werden stdout und stderr beim Start als Service in eine Datei umgelenkt Geht dies schief beendet sich openUTM LU62 so
78. angegeben werden In TRANSIT SERVER muss bei XLU ein Session Limit angegeben werden ebenso bei SNAP IX bzw beim IBM Communications Server in der Definition der lokalen LU Dieses Session Limit sollte um mindestens 2 gr er gew hlt werden als die oben angegebene Maximalzahl von Sessions Zwischen CICS VTAM und TRANSIT bzw SNAP IX oder IBM Communications Server muss die maximale RU Size vereinbart werden Sie muss bei CICS in der Session Definition bei VTAM TRANSIT SNAP IX und IBM Communications Ser ver in der Mode Definition angegeben werden Sie sollten hier nach M glichkeit den Standardwert 4096 verwenden siehe auch Abschnitt DEFINE SESSIONS auf Seite 78 Wenn von der UTM Anwendung aus ein CICS Programm angesprochen werden soll muss dieses Programm CICS in einer Program Definition bekannt gemacht werden Au erdem muss eine Transaction Definition in CICS auf den Programm namen verweisen U5461 J Z135 6 103 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 9 10 Der diesem CICS Programm zugeordnete CICS Transaktionscode muss in einer Transaction Definition von CICS festgelegt werden Um das Programm von der UTM Anwendung ansprechen zu k nnen muss dann in der openUTM Generie rung eine LTAC Anweisung mit dem CICS Transaktionscode als RTAC Parameter vorkommen In den Start Options von VTAM wird unter anderem mit dem Parameter SSCPNAME der CP Name des Host Systems generiert In
79. bei openUTM in den CICS Programmen angegeben Im Gegensatz zur LU6 1 Schnitt stelle bietet CICS bei LU6 2 auch die M glichkeit Transaktionscodes mit mehr als 4 Zei chen direkt im Programm anzugeben Dies ist wichtig da UTM Transaktionscodes bis zu 8 Zeichen lang sein k nnen Verwendung von Benutzerkennungen Bei verteilter Verarbeitung ist es oft sinnvoll dass der menschliche Endbenutzer nur an ei ner Stelle im Gesamtsystem Benutzerkennung und Passwort eingibt und damit seine Be rechtigung f r bestimmte Aktionen nachweist Die Benutzerkennung wird dann beim Auf bau der Auftraggeber Auftragnehmer Beziehung dem anderen Partner mitgeteilt so dass der Benutzer in den anderen Systemen ebenfalls nur bestimmte Berechtigungen hat Das Passwort dagegen wird blicherweise nicht ber das Netz bertragen Damit ein derartiges Verfahren funktionieren kann m ssen die Benutzerkennungen unter allen beteiligten Systemen eindeutig sein Die Systemverwalter der beteiligten Systeme m ssen also zumindest teilweise die gleichen Benutzerkennungen eintragen Bei openUTM werden Benutzerkennungen als USER in der KDCDEF Generierung angege ben bei CICS werden Benutzerkennungen blicherweise mit dem Produkt RACF verwaltet Sollen zusammen mit den Auftr gen auch Benutzerkennungen bertragen werden so muss bei openUTM LU62 und bei openUTM der Application Kontext UDTSEC angegeben werden Bei Verwendung des LU6 2 Protokolls m ssen sich Anwendungsprogram
80. beim IBM Communications Server muss der PU Name als CP Name bei der Node Definition eingetragen werden In TRANSIT bzw SNAP IX oder IBM Communications Server muss die MAC Adresse angegeben werden ber die der SNA Host erreicht werden soll Die Stellvertreter LU erh lt in TRANSIT bzw SNAP IX oder IBM Communications Server einen LU Alias Namen Dieser Name muss nicht mit dem bei 4 definierten LU Namen identisch sein Er muss in der openUTM LU62 Generierung angegeben werden 104 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren 20 21 Das CICS System erh lt in TRANSIT bzw SNAP IX oder IBM Communications Server einen LU Alias Namen Dieser Name muss nicht mit dem bei 3 definierten LU Namen identisch sein Er muss bei TRANSIT in der XLU und in der XRLU An weisung bei SNAP IX und beim IBM Communications Server in der Definition der Partner LU und bei der openUTM LU62 Generierung im Parameter REM LU ALI AS angegeben werden Nur bei Verwendung von TNSX Die Stellvertreter AE von openUTM LU62 muss in der openUTM LU62 Generie rung und im TNSX definiert werden 22 23 24 F r die Stellvertreter AE muss ein Application Process Title und ein Application Entity Qualifier festgelegt werden Beide sind in der openUTM LU62 Generierung und in der openUTM Generierung anzugeben Nur bei Verwendung von TNSX Die von der UTM Anwendung verwendete AE muss in der openUTM LU62 Gene
81. ber LU6 2 Verwendung der Programmschnittstelle CPI C 4 3 Verwendung der Programmschnittstelle CPI C 4 3 1 In CICS kann f r die LU6 2 Kommunikation auch die Programmschnittstelle CPI C benutzt werden anstelle der CICS Kommandos Da bei Kopplungen zwischen openUTM und LU6 2 Partnern ungleich CICS der LU6 2 Partner oft mit der Programmschnittstelle CPI C realisiert ist sollen im folgenden die obigen Beispiele der openUTM CICS Kommunikation auf die Programmschnittstelle CPI C bertragen werden Beispiele f r derartige Partner sind APPC MVS IMS System i5 fr her AS 400 Auch in openUTM kann OPI C anstelle von KDCS f r die OSI TP Kommunikation benutzt werden Wenn beide Partner CPI C benutzen so ist dies sehr hnlich einer openUTM openUTM Kopplung mit CPI C auf beiden Seiten oder einer openUTM OpenCPIC Kopplung Beides ist ausf hrlich in dem open UTM Handbuch Anwendungen erstellen mit X Open Schnittstellen beschrieben Soll eine transaktionsgesicherte Kommunikation ber OSI TP oder LU6 2 mit CPI C pro grammiert werden so ben tigt man zus tzlich zu CPI C noch eine Programmschnittstelle zum Anfordern und Best tigen eines Sicherungspunkts sowie zum Zur cksetzen einer Transaktion In openUTM und bei X Open wird hierzu die Programmschnittstelle TX ver wendet Bei IBM Produkten ist dagegen meist die Programmschnittstelle CPI RR Com mon Programming Interface for Resource Recovery mit den Aufrufen SRRCMIT und SRR BACK anzut
82. daf r dass zuvor mittels CONNECT PROCESS oder SEND erstellte Daten tats chlich abgesendet werden Das Kommando hat folgende Syntax EXEC CICS WAIT CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session ISSUE SIGNAL Das Kommando sendet eine Aufforderung an das UTM Anwendungsprogramm die Sen deberechtigung abzugeben Dieses Kommando ist bei einer Kopplung zu openUTM wir kungslos da das UTM Anwendungsprogramm nicht von der Ankunft einer derartigen Auf forderung unterrichtet wird U5461 J Z135 6 115 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 2 2 CICS Kommandos f r CICS Auftragnehmer Vorg nge EXTRACT PROCESS Das Kommando dient dazu vom UTM Anwendungsprogramm mittels APRO gesetzte Parameter abzufragen Das Kommando hat folgende Syntax EXEC CICS EXTRACT PROCESS L PROCNAME data area L MAXPROCLENGTH data value J C PROCLENGTH data value C SYNCLEVEL data area PROCNAME data area MAXPROCLENGTH data value und PROCLENGTH data value Erfragt den vom UTM Anwendungsprogramm bei APRO im Parameter KCRN gesetzten CICS Transaktionscode SYNCLEVEL data area Erfragt das von UTM Anwendungsprogramm bei APRO im Parameter KCOF gesetzte Synchronisations Level des LU6 2 Protokolls 0 entspricht KCOF B Basisfunktionen 1 entspricht KCOF H Handshake Funktionen 2 entspricht KCOF C Commit Funktionen RECEIVE Dieses Kommando wird verwendet um eine von einem
83. dem die IMS Anwendung im SNA Netz bekannt ist SNA netname Dieser Name muss mit dem RNETNAME Operanden in der korre spondierenden LPAP Anweisung der UTM Generierung bereinstimmen EDTNAME name 1 8 Zeichen langer Name unter dem der ISC Edit Prozess im IMS System bekannt ist Dieser Name muss mit dem DPN Operanden in der korrespondierenden SESCHA Anweisung der UTM Generierung bereinstimmen Makro TYPE Der Makro dient dazu den Beginn der Beschreibung einer Gruppe von VTAM Terminals des gleichen Typs einzuleiten Ihm folgen die TERMINAL und NAME Makros f r die Ter minals der Gruppe TYPE UNITYPE LUTYPE6 andere Parameter Der Operand hat folgende Bedeutung UNITYPE LUTYPE6 Es wird ein LU6 1 Ger tetyp definiert 238 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 1 IMS Generierung f r openUTM IMS Sessions Makro TERMINAL Mit diesem Makro werden physikalische und logische Eigenschaften eines VTAM Nodes des Typs definiert der in dem vorausgehenden TYPE Makro angegeben wurde TERMINAL NAME nodename MSGDEL SYSINFO OPTIONS FORCSESS COMPT1 SINGLE1 L DPM Bn IGNORE SEGSIZE size OUTBUF buffer size SESSION n Da EEE andere Parameter Die Operanden haben folgende Bedeutungen NAME nodename 1 8 Zeichen langer Name mit dem der SNA Netzname SNA netname f r die UTM Anwendung festgelegt wird Dieser Name muss mit dem LNETNAME Ope randen in der korrespondierenden LPAP Anweisung der UTM Generierung
84. der Software auch ein Online Hilfesystem ausgeliefert Die genannten Handb cher werden jeweils noch durch JavaDocs erg nzt 1 2 3 Readme Dateien Funktionelle nderungen und Nachtr ge der aktuellen Produktversion zu diesem Hand buch entnehmen Sie bitte ggf den Produkt spezifischen Readme Dateien e BS2000 OSD Sie finden die Informationen auf Ihrem BS2000 Rechner in der Freigabemitteilung Da teiname SYSFGM UTM 053 D und eventuell zus tzlich in einer Readme Datei Datei name SYSRME UTM 053 D Die Benutzerkennung unter der sich die Datei befindet erfragen Sie bitte bei Ihrer zust ndigen Systembetreuung Die Datei k nnen Sie mit dem Kommando SHOW FILE oder mit einem Editor ansehen oder auf einem Stan darddrucker mit folgendem Kommando ausdrucken PRINT DOCUMENT dateiname LINE SPACING BY EBCDIC CONTROL e UNIX Systeme Die Readme Datei und ggf weitere Dateien wie z B eine Handbucherg nzungsdatei finden Sie im urmpfad unter docs sprache e Windows Systeme Die Readme Datei und ggf weitere Dateien wie z B eine Handbucherg nzungsdatei finden Sie im utmpfad unter Docs sprache U5461 J Z135 6 19 nderungen gegen ber dem Vorg ngerhandbuch Einleitung 1 3 nderungen gegen ber dem Vorg ngerhandbuch Die wichtigsten nderung gegen ber dem Vorg ngerhandbuch sind Erweiterung der Generierungsparameter von openUTM LU62 Die bisher im TNSX ent haltenen Parameter wurden erg nzt Somit wird TNSX jetzt
85. des Systemverwalters Log Name des Partners aus Synclog Datei restauriert amp LOGNAME Bei einem Warmstart von openUTM LU62 wird neben dem eigenen Log Namen auch der Log Name amp LOGNAME des LU6 2 Partners der Synclog Datei entnom men sofern er bei einem vorangegangenen Lauf der Instanz durch einen erfolgrei chen Austausch der Log Namen bekannt geworden ist Diese Meldung erscheint nur w hrend der Initialisierung und dient lediglich der Information des Systemver walters openUTM LU62 beendet Diese Meldung wird als letzte in die Protokolldatei geschrieben wenn eine Instanz von openUTM LU62 normal durch Administration u62_adm e beendet wurde U5461 J Z135 6 267 Meldungen des Programms u62_tp Meldungen von openUTM LU62 026 027 Abbruch von openUTM LU62 im Modul amp MODULNAME Error Nummer ERRNUM Error Code ERRCODE Die openUTM LU62 Instanz hat sich aufgrund eines schwerwiegenden internen Fehlers beendet Die Angaben MODULNAME amp ERRNUM und amp ERRCODE bezeichnen interne Fehlerinformationen und sind f r die Fehleranalyse von gro er Bedeutung Sichern Sie den Inhalt des Dateiverzeichnisses opt 1ib utm1u62 PROT UNIX Systeme bzw Programme utm1u62 PROT Win dows Systeme Wenn m glich sollten Sie den Fehlerfall mit eingeschaltetem In stanz Trace nachstellen Abbruch durch den XAP TP Provider amp REASON Der XAP TP Provider hat einen schwerwiegenden Fehler festgestellt und eine Beendig
86. diesem Kommando wird eine positive Verarbeitungsquittung an das UTM Anwendungs programm gesendet Das Kommando ist nur dann erlaubt wenn Sync Level 1 oder 2 ein gestellt wurde und zuvor das UTM Anwendungsprogramm eine Verarbeitungsquittung angefordert hat Das UTM Anwendungsprogramm erkennt die Ankunft der Verarbeitungs quittung an der Anzeige KCRMGT C Das Kommando hat folgende Syntax EXEC CICS ISSUE CONFIRMATION CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session ISSUE ERROR Mit diesem Kommando wird eine Fehlermeldung oder negative Verarbeitungsquittung an das UTM Anwendungsprogramm gesendet Das UTM Anwendungsprogramm erh lt beim MGET KCRMGT E Das Kommando hat folgende Syntax EXEC CICS ISSUE ERROR CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session U5461 J Z135 6 113 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 SYNCPOINT Mit diesem Kommando werden alle Auftragnehmer Vorg nge aufgefordert das Transak tionsende einzuleiten Das Kommando ist nur bei Sync Level 2 erlaubt Das UTM Anwen dungsprogramm erkennt dies beim MGET an der Anzeige KCTAST P Das Kommando hat folgende Syntax EXEC CICS SYNCPOINT SYNCPOINT ROLLBACK Mit diesem Kommando wird die Transaktion zur ckgesetzt Das Kommando ist nur bei Sync Level 2 erlaubt Das UTM Anwendungsprogramm erkennt das R cksetzen der Trans aktion beim MGET an der Anzeige KCTAST R Das Ko
87. durch ein UTM Anwendungsprogramm TP_BEGIN_DIALOGUE_IND fd 10 10 46 40 line 2380 corr 1 lt Ein UTM Anwendungsprogramm wurde gestartet und will eine Verbindung zu einem CICS Anwendungsprogramm aufbauen GET_LU_STATUS tpid 00722838 lt 10 46 41 line 3069 corr 0 zero_sess NO active_sess 29 MC_ALLOCATE tpid 00984982 lt 10 46 41 line 3257 corr 1 tp_name UPSI sync_level SYNCPT plu_alias CICST6 security NONE openUTM LU62 baut eine Conversation zum gew nschten CICS Anwendungsprogramm mit dem Transaktionscode UPS1 auf An sync_level SYNCPT sieht man dass es sich um eine transaktionsgesicherte Verbindung handelt Es werden keine Benutzerkennung und kein Passwort gesendet TP_DATA_IND fd 10 10 46 42 line 3353 corr 1 lt udata_len 19 Die UTM Anwendung sendet 19 byte Daten In diesen 19 byte ist noch ein OSI TP Header enthalten MC_SEND_DATA tpid 00984982 lt 10 46 42 line 3448 corr 1 send_type NONE data_type APPLICATION len 2 openUTM LU62 sendet die Daten an das CICS Anwendungsprogramm weiter Hier sieht man dass es sich nur um 2 byte Benutzerdaten handelt Der OSI TP Header war also 17 byte lang Die L nge des OSI TP Header kann unterschiedlich sein TP_DEFERRED_END_DIALOGUE_IND fd 10 10 46 42 line 3488 corr 1 lt TP_PREPARE_IND fd 10 10 46 42 line 3557 corr 1 lt 68 U5461 J Z135 6
88. empfangen unerwartete Presentation Protocol Data Unit empfangen unerwartete Session Service Primitive empfangen Presentation Protocol Data Unit mit unbekanntem Parameter empfangen Presentation Protocol Data Unit mit unerwartetem Parameter empfangen OJJA oO D 1OoO Presentation Protocol Data Unit mit ung ltigem Parameter empfangen Bedeutung von amp RSN bei amp SRC gleich 7 5 Ein OSI TP Dialog vom Partner hat die Association belegt 292 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 352 353 OSI TP Partner XAP TP User hat Dialogwunsch abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber openUTM LU62 hat aufgrund einer ankommenden Conversation vom LU6 2 Part ner versucht einen OSI TP Dialog zum TP amp TPNAME des OSI TP Partners d h zum Transaktionscode amp TPNAME der UTM Anwendung aufzubauen Der ferne XAP TP User d h das UTM Anwendungsprogramm hat jedoch den OSI TP Dia log abgelehnt so dass bei openUTM LU62 eine TP_BEGIN_DIALOGUE confirma tion mit result rejected eingetroffen ist openUTM LU62 beendet daraufhin die Conversation zum LU6 2 Partner OSI TP Partner XAP TP Provider hat Dialogwunsch abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Reason amp RSN openUTM LU62 hat aufgrund einer ankommenden Conversation vom LU6 2 Part ner versucht einen OSI TP Dialog zum TP amp TPNAME des OSI TP Partners
89. erm glicht u a zusammen mit openUTM moderne eBusiness Appli kationen zu erstellen Bestehende UTM Anwendungen k nnen unver ndert mit WebTransactions in das World Wide Web bernommen und in Portale integriert werden WebTransactions enth lt mit dem Business Object Builder BizTransactions das openSEAS Werkzeug zum Erzeugen wiederverwendbarer Business Objekte Die Business Objekte werden aus bestehenden Anwendungen erzeugt z B BS2000 OSD und OS 390 Anwendungen Transaktionsanwendungen mit openUTM und SAP R 3 und k nnen je nach Bedarf als JavaBeans Net Komponenten oder Web Services verf gbar gemacht werden 12 U5461 J Z135 6 Einleitung Konzept und Zielgruppen dieses Handbuchs 1 1 Konzept und Zielgruppen dieses Handbuchs Das vorliegende Handbuch Verteilte Transaktionsverarbeitung zwischen openUTM und CICS IMS oder LU6 2 Anwendungen beschreibt wie man bei verteilter Transaktionsver arbeitung UTM Anwendungen in BS2000 OSD UNIX und Windows Systemen mit CICS IMS und anderen LU6 2 Anwendungen in IBM Systemen koppeln kann Es richtet sich an Systemverwalter Netzverwalter und Anwendungsprogrammierer Das Kapitel 2 enth lt allgemeine Informationen zu Kopplungen zwischen openUTM und IBM Systemen Die Kapitel 3 bis 5 beschreiben die LU6 2 Kopplung zwischen openUTM und IBM Syste men Kapitel 3 beschreibt das Gateway open UTM LUB 2 einschlie lich der Administration von openUTM LU62 Kapitel 4 und 5 gehen n h
90. gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P PEND FI lt Committed NORMAL SEND Client lt RETURN Diese Variante unterscheidet sich von der vorhergehenden dadurch dass die Antwortnach richt des UTM Anwendungsprogramms noch innerhalb der ersten Transaktion gesendet wird Bei der ersten Variante wird die Antwortnachricht in der zweiten Transaktion gesendet Die zweite Variante ist aufwendiger zu programmieren und erzeugt auch mehr Nachrichten als die erste Variante Sie hat aber den Vorteil dass eine eventuell mit dem SYNCPOINT gekoppelte Datenbankanderung erst nach Erhalt der Nachricht vom UTM Anwendungspro gramm festgeschrieben wird 126 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 5 PEND ER FR im UTM Anwendungsprogramm gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND LAST CONVID SYNCPOINT FMH5b Daten RequestCommit gt INIT PU ENDTA F SEND N MGE VGST 0 TAST P PEND ER FR lt FMH7 FMH7 Response gt Abend ASP3 Aana Im obigen Fall f hrt ein PEND ER oder PEND FR von UTM dazu dass das CICS Auftrag geberprogramm mit Abend ASP3 abgebrochen wird Dieser Abend kann vom CICS An wendungsprogramm nicht abgefangen werden Soll dies vermieden werden so muss im CICS Anwendungsprogramm das Kommando ISSUE PREPARE verwendet werden gt RECEIVE Client ALLOCATE CONNECT PROCESS
91. kann wahlweise eine Kom munikation mit oder ohne Transaktionssicherung betrieben werden Im folgenden wird zun chst das allgemeine Konzept von openUTM LU62 sowie dessen Bedienung beschrieben Im Kapitel openUTM CICS Kopplung ber LU6 2 auf Seite 75 werden dann die zu ber cksichtigenden Details einer openUTM CICS Kopplung ber LU6 2 dargestellt 3 1 Konzepte und Funktionen von openUTM LU62 3 1 1 Stellvertreterkonzept openUTM LU62 verh lt sich gegen ber einer UTM Anwendung wie eine Uber OSI TP gekoppelte Anwendung openUTM LU62 realisiert f r jede von einer UTM Anwendung zu erreichende LU6 2 Anwendung also z B f r jedes CICS eine Stellvertreter OSI TP An wendung Aus Sicht der LU6 2 Anwendung ist openUTM LU62 ein ferner LU6 2 Partner openUTM LU62 realisiert f r jede von einer LU6 2 Anwendung zu erreichende UTM Anwendung eine Stellvertreter LU Logical Unit Pro OSI CON Anweisung in einer UTM Anwendung wird eine Instanz von openUTM LU62 ben tigt Weitere Informationen zur OSI CON Anweisung siehe openUTM Handbuch An wendungen generieren U5461 J Z135 6 35 Konzepte und Funktionen von openUTM LU62 LU6 2 Kopplungen mit openUTM LU62 Sollen z B von 2 UTM Anwendungen 3 verschiedene CICS Systeme erreichen so sind 6 Instanzen von openUTM LU62 erforderlich siehe Abschnitt INSTANCE Anweisung auf Seite 43 Das Ganze wird an folgendem Bild veranschaulicht LU 4A AE 1A openUTM LU62 Instanz 1
92. keit der Instanz Trace und ob der XAP Trace eingeschaltet werden soll Mit dem Instanz Trace IN werden alle internen Abl ufe des Programms u62_tp protokolliert F r diesen Instanz Trace gibt es verschiedene Trace Levels die durch Zahlen dargestellt werden Jedes h here Level schlie t die Traces aller niedereren Levels mit ein Mit dem XAP TP Trace XAP werden alle internen Abl ufe der Komponenten XAP TP Provider und OSS protokolliert Im Einzelnen sind folgende Angaben bei trace_optionen m g lich in 1 Der Instanz Trace wird mit dem niedrigsten Level eingeschaltet Es werden nur die f r einen Protokoll Trace erforderlichen Trace Ein tr ge geschrieben Zum Protokoll Trace siehe Seite 66 Dieses Trace Level ist im Allgemeinen f r eine erste Fehlerdiagnose aus reichend in 2 Der Instanz Trace wird mit dem ausf hrlichen Level eingeschaltet in 3 Der Instanz Trace wird mit einer zus tzlichen Zeitmessung f r alle Aktivit ten gestartet Dieses Level ist zur Diagnose von Perfor mance Problemen gedacht in Der Instanz Trace wird mit dem ausf hrlichen Level eingeschaltet wie in 2 U5461 J Z135 6 55 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 xap Der XAP TP Trace wird eingeschaltet Sollen beide Traces eingeschaltet werden so muss in xap als trace_optionen angegeben werden Wird trace_optionen weggelassen so werden der Instanz Trace mit ausf hr lichem Level und der XAP TP Trace eingescha
93. mit ABEND abgebrochen Der LU6 2 Partner hat die Conversation abnormal mit Deallocate Abend abgebro chen openUTM LU62 beendet daraufhin den OSI TP Dialog zum OSI TP Partner d h zur UTM Anwendung ebenfalls abnormal mit U_LABORT_REQ Der eigentli che zugrundeliegende Fehler ist in der Regel im Anwendungsprogramm des LU6 2 Partners zu suchen Conversation zum LU6 2 Partner TP Name amp TPNAME LU6 2 Seite ist Auftraggeber vom Partner mit ABEND abgebrochen Siehe Kommentar zur Meldung 330 Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber durch Ausfall der LU6 2 Basis Software abgebrochen Die LU6 2 Basis Software hat sich beendet Bei Verwendung von TRANSIT hei t dies dass das TRANSIT Grundsystem oder der LU62Mgr beendet worden sind Dies wird von openUTM LU62 beim n chsten Aufruf der LU6 2 Basis Software bemerkt und f hrt zum abnormalen Abbruch des OSI TP Dialogs mit dem OSI TP Partner d h mit der UTM Anwendung mittels U_LABORT_REQ Conversation zum LU6 2 Partner TP Name amp TPNAME LU6 2 Seite ist Auftraggeber durch Ausfall der LU6 2 Basis Software abgebrochen Siehe Kommentar zur Meldung 332 288 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 334 335 336 337 338 Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber wegen Conversation Fehler abgebrochen Auf der Session die der Conversation zu
94. muss die openUTM Generierung eine entsprechende LTAC Anweisung enthal ten die mit den Parametern LPAP und RTAC auf das CICS System und den dorti gen Transaktionscode verweist Das UTM Anwendungsprogramm muss beim APRO diesen LTAC Namen verwenden Zus tzlich kann auch der LPAP Name beim APRO Aufruf angegeben werden Die Netzidentfikation des SNA Netzes wird in den Startparametern von VTAM fest gelegt Dieser Name muss auch an mehreren Stellen bei TRANSIT bzw SNAP IX bzw IBM Communications Server angegeben werden U5461 J Z135 6 107 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 2 openUTM CICS Kopplung programmieren Die LU6 2 Kommunikation zwischen CICS und openUTM kann bei CICS nur mit Hilfe von DTP Distributed Transaction Processing programmiert werden Asynchronous Proces sing mittels START und RETRIEVE ist bei LU6 2 nicht m glich CICS Programme werden blicherweise mit CICS Kommandos der Art EXEC CICS command option programmiert In den folgenden Abschnitten sind die wichtigsten CICS Kommandos f r die LU6 2 Kommunikation beschrieben Anstelle der blichen CICS Kommandos k nnen auch die CPI C Aufrufe verwendet werden Da CPI C auch in Nicht CICS Umgebung eine wich tige Programmschnittstelle f r die LU6 2 Kommunikation ist wird ab Seite 151 auch die Verwendung dieser Schnittstelle beschrieben F r die LU6 2 Kommunikation stehen bei CICS die folgenden Kommandos zur Verf gung AL
95. noch c angegeben werden Zustandsinforma tionen Uber alle open UTM LU62 Instanzen ausgegeben b Mit dem Schalter b werden die Daten in bin rer Form entsprechend einer vorgegebenen C Struktur ausgegeben Dieser Schalter kann eingesetzt werden f r Programme die die Ausgabe von u62_sta weiter verarbeiten wollen Die C Struktur ist definiert im Include File opt 1ib utm1u62 status h UNIX Systeme bzw Programme utmlu62 status h Windows Systeme u62_sta gibt zwei Uberschriftszeilen und pro openUTM LU62 Instanz eine Zeile aus Die Ausgabe sieht etwa wie folgt aus LLU name RLU name local OSI addr remote OSI addr XLN atot absy stot sbsy TO2CGEI4 CICST6 SMP22804 utm1u62 SMP22800 utm1u62 ok 4 1 4 1 Mit dem Schalter c erzeugt u62_sta z B folgende Ausgabe LLU name RLU name Number of CPSVCMG sessions DECINO5C P391 P391SSP 2 58 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren Bedeutung der Ausgabefelder LLU name RLU name local OSI addr Name der lokalen LU wie er in der Generierungsdatei mit LOC LU ALIAS angegeben wurde Name der Partner LU wie er in der Generierungsdatei mit REM LU ALIAS angegeben wurde TNSX Name der lokalen Application Entity wie er in der Generierungsdatei mit LOC AE angegeben wurde Wird kein TNSX verwendet Lokaler T Selektor ohne Formatangabe mit dem lokalen Port in Klammern Beispiel LOC_TSEL 23766 remote OSI addr XLN TNSX Name de
96. rierung und im TNSX definiert werden 25 26 27 28 Fur die UTM Anwendung muss ein Application Process Title und ein Application Entity Qualifier festgelegt werden Beide sind in der openUTM LU62 Generierung und in der openUTM Generierung anzugeben Die UTM Anwendung und die Stell vertreter AE m ssen unterschiedliche Application Process Title haben Die Appli cation Entity Qualifier k nnen jedoch identisch sein Zwischen openUTM LU62 und der UTM Anwendung muss ein Application Context vereinbart werden Es empfiehlt sich hier den Standardwert UDTSEC zu ver wenden Wird UDTAC verwendet so muss im Falle von TRANSIT bei PAIR_EXT der dritte und vierte Parameter jeweils auf NONE gesetzt werden Bei Verwendung von UDTAC sind keine verteilten Transaktionen m glich Andere Werte sind nicht zul ssig Die zwischen openUTM LU62 und der UTM Anwendung verf gbaren parallelen Verbindungen m ssen mittels Generierung in Contention Winner und Contention Loser Verbindungen aufgeteilt werden Die CONTWIN Werte aus der openUTM LU62 Generierung und der openUTM Generierung sollten aufaddiert genau die generierte Anzahl von parallelen Verbindungen ergeben 29 30 Der T Selektor sowie die Port Nummer des Access Point der UTM Anwendung m ssen auch im TNSX Eintrag oder direkt in der openUTM LU62 Generierung 24 eingetragen sein Damit wird ber CMX die Verbindung zwischen openUTM LU62 und der UTM Anwendung hergestellt U5461 J Z1
97. schen von Nachrichten Segmenten e Abbruch DEALLOCATE_ABEND einer LU6 2 Conversation Benutzung von Formatnamen MFS Message Format Service ist die IMS Komponente zum Behandeln formatierter Ein und Ausgaben auf zeichenorientierten Bildschirmen Typ 3270 DL I Anwendungsprogramme erhalten beim Einlesen einer 3270 Nachricht im Aufruf GU einen Formatnamen den sogenannten MOD Name Dabei steht MOD f r Message Output Descriptor Beim ISRT k nnen sie einen MOD Name mitgeben Sollen derartige Program me unver ndert f r LU6 2 Kommunikation verwendet werden so muss die LU6 2 Edit Exit Routine DFSLUEEO f r diese Zwecke verwendet werden Die LU6 2 Partnerprogramme m ssen dann am Anfang der Nachricht den Formatnamen senden und erhalten ebenso am Anfang der R cknachricht einen Formatnamen Ablauf Beispiele mit DL I Programmen In den folgenden Beispielen werden Abl ufe mit openUTM und IMS Programmen darge stellt Auf beiden Seiten sind nur die Programmaufrufe f r die LU6 2 Kommunikation auf gef hrt F r die Kommunikation mit dem openUTM Client oder dem IMS Client sind weitere Programmaufrufe notwendig Die R ckgabewerte im UTM Anwendungsprogramm sind kursiv dargestellt U5461 J Z135 6 197 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 Synchroner Aufruf einer IMS Transaktion von openUTM ohne Transaktionssicherung IMS Anwendung UTM Anwendung APRO DM KCOF B KCRN A MPUT NE KCRN A PEND KP
98. security SEC_NONSECURE U5461 J Z135 6 99 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 prop_delay PROP_D user_def_parm_1 1 user_def_parm_2 1 user_def_parm_3 1 target_pacing_count max_send_btu_size Is_role USE_PORT_ max_ifrm_rcvd 0 dlus_retry_timeout dlus_retry_limit branch_link_type adj_brnn_cp_support dddlu_offline_suppo initially_active restart_on_normal_d react_timer 30 react_timer_retry test_timeout 10 test_timer_retry xid_timer 10 xid_timer_retry 5 ack_timeout 5000 ELAY_LAN 28 28 28 7 1033 DEFAULTS 0 0 NONE ALLOWED rted NO YES eact NO 65535 5 p_bit_timeout 5000 t2_timeout 100 rej_timeout 10 busy_state_timeout idle_timeout 30 max_retry 3 define_partner_lu plu_alias parallel_sess_supp 30 YES nax_mc_ll_send_size 0 conv_security_ver NO plu_alias CICST6 description parallel_sess_supp define_partner_lu fqplu_name DESNI000 A9CICST6 plu_un_name A9CICST6 YES nax_mc_ll_send_size 0 conv_security_ver NO 13 description Auto defined default LU fqplu_name DESNI000 M88 plu_un_name lt 0000000000000000 gt 10 43 20 3 43 3 100 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren define_local_lu lu_alias TO2CGEI4 list_name desc
99. sie die Daten verworfen selbtst ndig die Senderichtung gewechselt und eine negative Quittung an den LU6 2 Partner gesendet openUTM LU62 erh lt in dieser Situation den Fehlercode AP_STATE_CHECK und baut daraufhin die Conversation und den zugeh rigen OSI TP Dialog ab U5461 J Z135 6 289 Meldungen des Programms u62_tp Meldungen von openUTM LU62 339 Auf Conversation zum LU6 2 Partner TP Name amp TPNAME LU6 2 Seite ist Auftraggeber wurde AP_STATE_CHECK fuer ein RECEIVE Verb gemeldet gt Abbruch der Conversation durch openUTM LU62 Siehe Kommentar zur Meldung 338 340 Ankommende Conversation zum LU6 2 Partner abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Ablauf des Timers zur Ueberwachung des Associationsaufbaus Der LU6 2 Partner hat eine Conversation zum TP amp TPNAME aufgebaut amp TPNAME bezeichnet also den UTM Transaktionscode openUTM LU62 kann jedoch im Moment aufgrund eines Mangels an freien parallelen Verbindungen keinen OSI TP Dialog zum OSI TP Partner d h zur UTM Anwendung aufbauen Wird innerhalb einer bestimmten Wartezeit keine parallele Verbindung frei so weist openUTM LU62 die Conversation zur ck Diese maximale Wartezeit ist in openUTM LU62 mit dem Parameter ALLOC TIME konfigurierbar der Standardwert betr gt 30 Sekunden Erscheint diese Meldung h ufiger so sollte entweder das Sessionlimit in TRANSIT der Generierungsparameter SESS MAX bei XMODE erniedrigt oder die Anzahl der parall
100. stehen darf Dem letzten Parameter darf kein Kom ma folgen Optionale Parameter werden in eckigen Klammern dargestellt F r fehlende op tionale Parameter wird der Standardwert angenommen Die Reihenfolge der Parameter in nerhalb der INSTANCE Anweisung ist beliebig Ein Parameter muss immer innerhalb einer Zeile stehen Zeilen die mit einem Stern oder Nummernkreuz beginnen werden als Kommentar behandelt und von u62_gen berlesen Zul ssige Zeichen f r Namen sind alle druckbaren ASCII Zeichen Buchstaben Ziffern Sonderzeichen mit Ausnahme der folgenden Sonderzeichen Stern Komma Semikolon Leerzeichen 0x20 Tabulator 0x09 42 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren 3 2 2 INSTANCE Anweisung Mit einer INSTANCE Anweisung legen Sie die Stellvertreter und die Parameter fest f r die Verbindung zwischen einem UTM Accesspoint und einer LU6 2 Anwendung d h f r eine openUTM LU62 Instanz Ab der Version 5 1 von openUTM LU62 k nnen Sie w hlen ob Sie die TCP IP Adress In formation im TNSX oder in der INSTANCE Anweisung generieren Wenn die Information in der INSTANCE Anweisung generiert wird entfallt die Verwendung von TNSX Stellvertreter LU Die Stellvertreter LU wird mit dem Parameter LOC LU ALIAS definiert Stellvertreter AE Wenn Sie die TCP IP Adress Information in der INSTANCE Anweisung generieren muss die Stellvertreter AE mit den
101. werden Zur De finition eines Alternate PCB sind Generierungsanweisungen an drei unterschiedlichen Stel len erforderlich 1 PCB Anweisung in IMS PSBGEN Beispiel PCB TYPE TP MODIFY YES PSBGEN PSBNAME IMSTOJUMS CMPAT YES LANG COBOL 2 Definition von ACBGEN Beispiel ACBGEN EXEC ACBGEN COMP POSTCOMP G SYSIN DD BUILD PSB IMSTOJMS 180 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren 3 APPLCTN Makro mit Parameter PSB und TRANSACT Makro Beispiel APPLCTN PSB IMSOJMS PGMTYPE TP TRANSACT CODE IMSD MSGTYPE RESPONSE INQUIRY NO MODE SNGL Zus tzlich muss mit einem sogenannten LU6 2 Descriptor in IMS PROCLIB DFS62DTx ein LTERM Name definiert und diesem LU Name TP Name und MODE Name zugewie sen werden Dies sieht z B wie folgt aus A UTMIMSO1 LUNAME APPCLUX TPNAME UTMTACOl MODE APPCMODE SYNCLEVEL N Der LTERM Name hei t in diesem Beispiel UTMIMSO1 Man kann auch beide Typen der Partner Definition kombinieren indem man beim LU6 2 Descriptor anstelle der Parameter LUNAME TPNAME MODE den Parameter SIDE ver wendet und damit auf eine Side Information verweist Im Gegensatz zu CICS gibt es bei IMS keine Festlegung der Maximalzahl von Sessions zu einer Partner LU Diese Maximalzahl wird in der APPL Definition von VTAM festgelegt 5 1 5 VTAM Generierung Ein erster Teil der ben tigten VTAM Generierung wurde oben beim APPL Makro beschrie ben Der f r die LU6 2
102. wurde Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPLNK repr sentiert den internen Zustand der Association 0 Association nicht verkn pft 1 Association mit Channel verkn pft 2 Association mit Instanz verkn pft amp XPNDIA siehe Tabelle auf Seite 341 P017 OSS Dekodierfehler amp XPPDU amp XP1DIA amp XP2DIA amp XP3DIA Diese Meldung wird ausgegeben wenn OSS beim Dekodieren einer TP CCR oder Benutzerdaten PDU einen Fehler erkennt Die Inserts haben folgende Bedeutung XPPDU Bedeutung 0 PDU_UNKNOWN 1 TP_BEGIN_DIALOGUE_RI 2 TP_BEGIN_DIALOGUE_RC 3 TP_BID_RI 4 TP_BID_RC 5 TP_EBD_DIALOGUE_RI 6 TP_END_DIALOGUE_RC 7 TP_U_ERROR_RI 8 TP_U_ERROR_RC 9 TP_ABORT_RI 10 TP_GRANT_CONTROL_RI 11 TP_REQUEST_CONTROL_RI 12 TP_HANDSHAKE_RI 13 TP_HANDSHAKE_RC 14 TP_HSK_AND_GRT_CTRL_RI 15 TP_HSK_AND_GRT_CTRL_RC 16 TP_DEFER_RI U5461 J Z135 6 329 Meldungen des XAP TP Providers Meldungen von openUTM LU62 XPPDU Bedeutung 17 TP_PREPARE_RI 18 TP_HEURISTIC_REPORT_RI 19 TP_TOKEN_GIVE_RI 20 TP_TOKEN_PLEASE_RI 21 TP_RECOVER_RI 22 TP_INITIALIZE_RI 23 TP_INITIALIZE_RC 24 CCR_INITIALIZE_RI 25 CCR_INITIALIZE_RC 26 CCR_BEGIN_RI 27 CCR_BEGIN_RC 28 CCR_PREPARE_RI 29 CCR_READY_RI 30 C
103. 0 0 47 47 line 6682 corr 2 lt TP_COMMIT_IND fd 1 0 47 47 line 6752 corr 2 lt TP_DONE_REQ fd 0 0 47 47 line 6827 corr 2 gt TP_COMMIT_COMPLETE_IND fd 0 0 47 48 line 6903 corr 2 lt TP_COMMIT_COMPLETE_IND fd 1 0 47 48 line 6975 corr 2 lt Alle Aufrufe von TP_COMMIT_REQ bis zum TP_COMMIT_COMPLETE_IND dienen dazu das Transaktionsende protokollkonform durchzufthren 72 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren MC_SEND_DATA tpid 00133014 lt 10 47 48 line 7244 corr 2 send_type NON data_type PS_HEADER Committed MC_DEALLOCATE tpid 00133014 lt 10 47 48 line 7286 corr 2 dealloc_type FLUSH Nach erfolgtem Transaktionsende auf OSI TP Seite sendet openUTM LU62 ein Committed an CICS und beendet anschlie end die Conversation mit MC_DEALLOCATE Damit sind Transaktion und Conversation auch auf LU6 2 Seite beendet U5461 J Z135 6 73 74 U5461 J Z135 6 4 openUTM CICS Kopplung ber LU6 2 In diesem Kapitel finden Sie die Aspekte der openUTM CICS Kopplung ber LU6 2 bez g lich Generierung und Programmierung 4 1 openUTM CICS Kopplung generieren 4 1 1 Definitionen in CICS In CICS sind folgende Definitionen erforderlich Festlegung der APPLID F r jede Instanz von openUTM LU62 eine Connection und eine Session
104. 1 Fehler beim Schreiben in die Pipe zum Prozess mit PID amp PID errno amp ERRNO amp ERRTEXT Beim Schreiben in die Output Pipe zum Administrationsprogramm oder zum Write Log D mon mit der PID amp PID ist der Fehler errno amp ERRNO aufgetreten Da es sich hierbei um einen schwerwiegenden Fehler handeln muss wiederholt u62_tp im Gegensatz zu den beiden obigen Fehlern ENOBUFS EAGAIN den Schreib versuch nicht Quittung zum Administrationsprogramm verworfen Beim ffnen einer Named Pipe zu einem Administrationsprogramm oder beim Schreiben in diese Pipe ist ein Fehler aufgetreten der noch nicht zum Abbruch von u62_tp gef hrt hat D h dieser Meldung geht immer eine der Meldungen 051 054 voraus Unbekannte Meldung Ox amp HEX ueber Pipe empfangen u62_tp hat eine interne Nachricht mit dem unbekannten Nachrichtentyp amp HEX 4 stellig hexadezimal empfangen Diese Meldungen deuten entweder auf einen Kommunikationsfehler zwischen u62_tp und den Administrationsprogrammen oder auf eine fehlerhafte Installation von open UTM LUB2 hin inkompatible Versionen von u62_tp und u62_adm bzw u62_sta Unbekannte Meldung Ox amp HEX vom Administrationsprogramm empfangen Siehe Kommentar zur Meldung 056 SNMP wird in dieser Version nicht unterstuetzt Meldung Ox amp HEX negativ quittiert Siehe Kommentar zur Meldung 056 Fehler beim Oeffnen der Pipe zum Write Log Daemon mit PID amp PID errno amp ERRNO amp ERRTEXT Der Wri
105. 2 CEDA View TRANSaction UPSI TRANSaction UPSI 9 Group KNAS1IIND DEscription PROGra UTMCICS1 8 TWasize 00000 PROFile DFHCICST PArtitionset STAtus Enabled PRIMedsize 00000 TASKDATALoc Below TASKDATAKey User STOrageclear No RUnaway System SHutdown Disabled Solate Yes RECOVERY DTimout No Ndoubt Wait RESTart No SPurge No TPUrge No DUmp Yes TRACe Yes COnfdata No 86 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren VTAM Generierung Start Options SSCPNAME M88 NETID DESNIOOO Major Nodes PO2CGE PU ADDR C1 DISCNT NO DLOGMOD SNX32702 IDBLK 017 IDNUM 2000E ISTATUS ACTIVE MAXDATA 1033 MAXOUT MAXPAT MODETA PACING PUTYPE SSCPFM USSSCS USSTAB USSSCS VPAC ING 0 2 MOD3270 PATH Do RPNAM G56TRNOO TO2CGEI4 LU OCADDR 0 SSTAB ISTINCDT ODETAB MODLU62 ESSCB 32 ACING 3 VPACING 2 SSCPFM FSS U w OL Application Definitions AOCICS VBUILD TYPE APPL A9CICST6 APPL EAS 160 ACBNAME A9CICST6 PARSESS YES AUTH ACQ BLOCK TALNO 000440002222000E LOGMOD MODDIS89 14 ACF VTAM USS TABLE 5 15 U5461 J Z135 6 87 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 Logon Mode Table MODLU62 MODETAB MODDIS89 MODEENT LOGMODE MODDIS89
106. 2 Partner m glich Ebenso wie bei Meldung 321 beschrieben kann die Fehlersituation nur durch Stoppen Umgenerieren und erneutes Starten der LU6 2 Basis Software und oder openUTM LU62 beseitigt werden Aktiver Aufbau einer Conversation zum Resync TP X 06F2 fehlgeschlagen Der Sync Level AP_CONFIRM_SYNC_LEVEL wird von der LU6 2 Basis Software nicht unterstuetzt openUTM LU62 hat zum Austausch der Log Namen bzw zum Abgleich von Trans aktionszustanden versucht eine Conversation zum Resync TP des LU6 2 Partners aufzubauen Diese Conversation benutzt immer den Sync Level CONFIRM 1 Die LU6 2 Basis Software l sst jedoch zwischen der lokalen und fernen LU nur Conversations mit dem Sync Level NONE 0 zu In TRANSIT muss hierzu der Kon figurationsparameter PAIR_EXT geandert werden 312 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 524 525 526 530 Da das Resync TP nur dann angesto en wird wenn der OSI TP Partner d h die UTM Anwendung Transaktionssicherung w nscht sollte der Sync Level im Para meter PAIR_EXT gleich auf den Wert SYNCLEVEL gesetzt werden aber nat rlich nur wenn der LU6 2 Partner dies auch unterst tzt Aktiver Aufbau einer Conversation zum Resync TP X 06F2 fehlgeschlagen LU6 2 Basis Software laeuft nicht Derzeit ist keine Kommunikation ber LU6 2 m glich weil die LU6 2 Basis Soft ware also bei TRANSIT das TRANSIT Grundsystem oder der LU62Mgpr nicht g
107. 2_tp 512 513 515 Die LU Alias Name amp ALIASNAME Netzname amp NETNAME hat andere Daten von einer frueheren Aktivierung gespeichert als die lokale LU Der LU6 2 Partner hat einen Warmstart durchgef hrt wobei die bei ihm gespei cherten Daten Netzwerkname der eigenen LU eigener Log Name Log Name von openUTM LU62 nicht mit den Werten bereinstimmen die openUTM LU62 jeweils daf r gespeichert hat Diese Fehlersituation ist so schwerwiegend dass openUTM LU62 nun keine OSI TP Dialoge mit Functional Unit Commit und keine Conversations mit Sync Level 2 mehr unterst tzt bis alle Sessions zum LU6 2 Partner abgebaut und da nach die Log Namen erfolgreich ausgetauscht werden Formatfehler festgestellt in einer von der LU Alias Name amp ALIASNAME Netzname amp NETNAME empfangenen Syncpoint Nachricht In einer der Syncpoint Nachrichten Exchange Log Name oder Compare States die von der Partner LU Alias Name in der LU6 2 Basis Software und UTM Gene rierung amp ALIASNAME Netzwerkname im SNA Netz amp NETNAME empfangen wurde war ein Formatfehler enthalten In diesem Fall weist zwar openUTM LU62 alle angekommenen OSI TP Dialoge mit Functional Unit Commit die auf das Er gebnis des Austausches der Log Namen warten zur ck der Fehler wird jedoch nicht als permanenter Fehler angesehen D h vor dem Aufbau der n chsten Conversation mit Sync Level 2 wird auf jeden Fall ein erneuter Austausch der Log
108. 35 6 105 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 31 32 Entsprechend den ISO Protokollvorschriften muss f r die von der UTM Anwendung verwendete AE ein S Selektor und ein P Selektor vergeben werden Diese S und P Selektoren m ssen im TNSX und in der openUTM Generierung angegeben wer den Es empfiehlt sich leere S und P Selektoren zu verwenden Falls kein TNSX verwendet wird sind S und P Selektor immer leer 33 Der Host Name des Systems auf dem die UTM Anwendung l uft muss eingetra gen werden im TNSX als IP Adresse bei dem Namen der in der Generierung von openUTM LU62 bei REM AE verwendet wird oder direkt in der open UTM LU62 Generierung als Host Name im DNS bzw in etc hosts Wenn openUTM LU62 und die UTM Anwendung auf demselben Rechner laufen kann hier localhost verwendet werden 34 35 Entsprechend den ISO Protokollvorschriften muss f r die Stellvertreter AE ein S Selektor und ein P Selektor vergeben werden Diese S und P Selektoren m s sen im TNSX und in der openUTM Generierung angegeben werden Es empfiehlt sich leere S und P Selektoren zu verwenden Falls kein TNSX verwendet wird sind S und P Selektor immer leer 36 Der T Selektor der Stellvertreter AE muss eingetragen werden im TNSX oder direkt in der open UTM LU62 Generierung und in der OSI CON Anweisung der UTM Generierung 37 Die Port Nummer der Stellvertreter AE muss eingetragen werden i
109. 35 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 5 PEND ER FR im UTM Anwendungsprogramm CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND CMDEAL SRRCMIT FMH5 Datent RequestCommit gt INIT PU ENDTA F SEND N MGE VGST 0 TAST P PEND ER FR lt FMH7 FMH7 Response gt RR_BACKED_OUT U5461 J Z135 6 157 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 6 PEND RS im UTM Anwendungsprogramm CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND SRRCMIT FMH5 Daten RequestCommit gt INIT PU ENDTA R SEND N MGE VGST 0 TAST P PEND RE lt Committed RR_OK CMSEND CMDEAL SRRCMIT Daten RequestCommit gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P MPUT RM KCRN lt PEND RS lt FMH7 FMH7 Response gt RR_BACKED_OUT CMSEND CMDEAL SRRCMIT Daten RequestCommit gt INIT PU ENDTA F SEND N MGET NT KCRN lt MGET VGST 0 TAST P PEND FI lt Committed RR_OK 158 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 7 Einschrittvorgang ohne Transaktionssicherung CMINIT CMALLC CMSEND CMRCV PMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MPUT NE PEND FI lt Daten CEB lt CM_DEALLOCATED_NORMAL 8 Verarbeitungsquittung ohne Transaktionssi
110. 6 277 Meldungen des Programms u62_tp Meldungen von openUTM LU62 050 051 052 053 Read an Input Pipe liefert Fehler ENOBUFS Beim Lesen mit read aus einer Named Pipe ist der Fehler errno ENOBUFS auf getreten d h im Moment besteht ein Engpass an Systemspeicher u62_tp wieder holt daraufhin nach einer Wartezeit von 1 4 Sekunde den Leseversuch bei erneu tem Auftreten des Fehlers ENOBUFS wird dann allerdings keine Fehlermeldung mehr ausgegeben Tritt dieser Fehler mehr als 20 mal unmittelbar hintereinander oder mehr als 60 mal insgesamt w hrend der Gesamtlaufzeit von u62_tp auf so beendet sich das Programm abnormal Fehler beim Oeffnen der Pipe zum Administrationsprogramm mit PID amp ADMPID errno amp ERRNO amp ERRTEXT Alle Auftr ge von den Administrationsprogrammen u62_adm und u62_sta an u62_tp werden von u62_tp durch eine R ckmeldung quittiert auch u62_adm e Schl gt das ffnen der Named Pipe mit der Systemfunktion open zum Senden der R ck meldung fehl so gibt u62_tp diese Meldung aus Der Inhalt der Variablen errno amp ERRNO gibt die genauere Ursache daf r an Da die Administrationsprogramme nur maximal 5 Sekunden auf die Antwort von u62_tp warten und sich nach Ablauf dieser Wartezeit beenden kann es bei zeitauf wendigen Auftr gen wie der Statusanzeige unter h herer Last vorkommen dass das Administrationsprogramm seine Eingabe Pipe wieder gel scht hat wenn u62_tp seine Quittung sende
111. 61 J Z135 6 349 Meldungen von u62_sta Meldungen von openUTM LU62 11 12 13 16 17 80 81 82 83 84 Instanz amp INST Fehler beim Lesen aus der Input Pipe amp PIPEFILE Anzahl gelesener Bytes fehlerhaft Keine open UTM LU62 Instanz aktiv Die angegebene Instanz ist nicht aktiv Instanz amp INST Kommando nicht erkannt Vermutliche Ursache u62_sta und u62_tp geh ren aufgrund einer fehlerhaften Installation von open UTM LU62 zu unterschiedlichen Versionen Instanz amp INST Unerwarteter Returncode amp RETCODE empfangen Vermutliche Ursache u62_sta und u62_tp geh ren aufgrund einer fehlerhaften Installation von open UTM LU62 zu unterschiedlichen Versionen Instanz amp INST Fehler beim Verbindungsaufbau ueber Sockets errno amp ERRNO amp ERRTEXT u62_sta kann die Socketverbindung zur Instanz amp INST nicht aufbauen Der Fehler code ERRNO stammt von der Systemfunktion connect Instanz amp INST Fehler beim Absenden der Meldung zum Gateway errno amp ERRNO amp ERRTEXT Instanz amp INST Fehler beim Absenden der Meldung zum Gateway Anzahl geschriebener Bytes fehlerhaft Die Systemfunktion send zum Absenden des Requests an die Instanz hat nicht das erwartete Ergebnis n mlich die L nge der Nachricht in Byte geliefert Dieses Fehlverhalten f hrt jedoch nicht zum Abbruch des Administrationsprogramms Instanz amp INST Fehler beim Abholen der Quittung vom Gateway errno amp E
112. ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPOSAS Index der betroffenen Association amp XPASST Zustand der betroffenen Association Instance Allocation Timeout amp ACPNT amp OSLPAP amp XPOSAS Diese Meldung wird ausgegeben wenn der Versuch eine XAP TP Instanz fur eine Verbindung zu allokieren innerhalb einer vorgegebenen Zeitspanne gescheitert ist amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPOSAS Index der betroffenen Association 332 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers P101 CMX Error amp ACPNT amp OSLPAP Diese Meldung wird ausgegeben wenn ein CMX Fehler aufgetreten ist Zus tzlich wird die Meldung P012 ausgegeben amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung Eine m gliche Ursache kann sein dass in der TNSX Generierung die Eintr ge f r PSEL und SSEL fehlen U5461 J Z135 6 333 Insert XPERR Meldungen von openUTM LU62 10 2 1 Allgemeine Inserts der XAP TP Meldungen XPRET Bedeutung 2 Not first process of application 1 Function call not successful due to permanent error 2 Function call not successful due to transient error Retry the call later 3 Function call not successful data flow stopped Continue after event GO 4 Session ca
113. AME der UTM Anwendung zu belegen Der lokale XAP TP Provider hat jedoch den Request abgelehnt openUTM LU62 bricht daraufhin die Conversation zum LU6 2 Partner ab Bedeutung von amp RES Association Allocation Request dauerhaft abgelehnt 2 Association Allocation Request vor bergehend abgelehnt Bedeutung von amp SRC ACSE Service User ACSE Service Provider Presentation Service Provider N M oO APM Service Provider Association Pool Manager Bedeutung von amp RSN 1 kein Grund angegeben CCR Version 2 nicht verf gbar Versions Inkompatibilit t Contention Winner Eigenschaft abgelehnt lokaler oder ferner Application Entity Title AET ung ltig 0 1 2 3 Bid mandatory Wert abgelehnt 6 7 kein Association Pool gefunden f r den angegebenen AET 58 Alle Associations aus dem Association Pool sind belegt jedoch gestatten die Pool Grenzen den Aufbau weiterer Associations Der XAP TP Provider hat mit dem Auf bau weiterer Associations begonnen 59 Alle Associations aus dem Association Pool sind belegt und die Pool Grenzen gestat ten keinen Aufbau weiterer Associations 60 Der Timer des Association Pool Managers ist abgelaufen Dieser Timer bestimmt wie lange maximal auf die Freigabe einer Association gewartet wird wenn alle Asso ciations aus dem Pool belegt sind 61 Die Association soll f r eine protected Conversation
114. AP Die bei Association indication bzw confirmation mitgegebene Adresse enth lt f r die SSAP Information eine falsche Version 14 ADDRESS_INVALID_S_SEL_LENGTH Die bei Association indication bzw confirmation mitgegebene Adresse enth lt keinen g ltigen Teil f r den Session Selektor 15 ADDRESS_NO_PARTNER_MODE Die bei Association indication bzw confirmation mitgegebene Adresse enth lt keinen g ltigen Teil f r den Network und Transport Selektor 16 ADDRESS_TNSX_ERROR Die bei Association indication bzw confirmation mitgegebene Adresse wird vom TNS abgewiesen 17 UNKNOWN_PARTNER Die bei Association indication bzw confirmation mitgegebene Adresse ist in der loka len Anwendung nicht bekannt 18 WRONG_APPLICATION_CONTEXT_NAME Der bei Association indication bzw confirmation mitgegebene Application Context Name entspricht nicht dem in der lokalen Anwendung generierten Application Con text Namen 19 ABSTRACT_SYNTAX_MISSING Bei Association indication bzw confirmation werden weniger abstrakte Syntaxen un terst tzt als in der lokalen Anwendung generiert wurden 20 OSITP_SYNTAX_MISSING Bei Association indication bzw confirmation wird die abstrakte Syntax f r OSI TP nicht unterst tzt 338 U5461 J Z135 6 Meldungen von openUTM LU62 Insert XPRJCT XPRJCT Bedeutung 21 NO_TP_INITIALIZE Bei Association indicatio
115. Ableh nung des OSI TP Dialogwunsches f hrt Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber User Id oder Passwort zu lang Laenge der User Id amp ULEN Laenge des Passwortes amp PLEN openUTM LU62 hat vom OSI TP Partner d h von der UTM Anwendung eine TP_BEGIN_DIALOGUE indication mit Initialisierungsdaten empfangen und diese Daten als Security Daten interpretiert Application Context UDTSEC Bei der Dekodierung dieser Daten hat sich herausgestellt dass die L nge der angegebe nen Benutzerkennung amp ULEN oder des angegebenen Passworts amp PLEN den Ma ximalwert von 10 berschreitet der an der LU6 2 Schnittstelle vorgegeben ist Da also die Security Daten dem LU6 2 Partner nicht in voller L nge bermittelt werden k nnen lehnt openUTM LU62 den OSI TP Dialogwunsch ab Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Die leere User Id ist unzulaessig Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber User Id als Octet String ist unzulaessig U5461 J Z135 6 299 Meldungen des Programms u62_tp Meldungen von openUTM LU62 384 385 386 390 391 392 Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Ein leeres Passwort ist unzulaessig Ankommender Dialogwunsc
116. Application Context UDTAC oder UDTDISAC generiert wurde aber von einem vorangegangenen Start die Synclog Datei amp SYNCLOG noch vorhanden ist Dies kann nur geschehen wenn zwischen zwei Starts von openUTM LU62 die Konfiguration ge ndert wurde so dass der Application Context von UDTCCR oder UDTSEC auf UDTAC oder UDTDISAC ge ndert wurde Bei Verwendung von UDTAC oder UDTDISAC gibt es keine Trans aktionssicherung deshalb wird von openUTM LU62 auch keine Synclog Datei angelegt Die noch bestehende Datei amp SYNCLOG wird jedoch vorsichtshalber nicht gel scht Wenn diese Datei tats chlich nicht mehr ben tigt wird muss sie vom Systemverwalter manuell gel scht werden Fehler beim Oeffnen der Synclog Datei amp SYNCLOG errno amp ERRNO amp ERRTEXT Abbruch von openUTM LU62 da CCR Syntax konfiguriert ist W hrend des Warmstarts ist beim ffnen der Synclog Datei amp SYNCLOG mit allen Informationen zum erfolgreichen Wiederanlauf ein Fehler aufgetreten der durch den Inhalt der Variablen errno amp ERRNO genauer spezifiziert wird Da in dieser Datei m glicherweise wichtige Informationen ber abgebrochene Transaktionen enthalten sein k nnen bricht openUTM LU62 in dieser Situation die Initialisierung ab Ist sichergestellt dass kein Transaktionswiederanlauf notwendig ist so kann mit dem Schalter c ein Kaltstart veranlasst werden 274 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 033 034
117. Aufrufsyntax opt lib utmlu62 u62_adm tonL trace_optionen J 1 loc_lu_alias_name opt lib utmlu62 u62_adm tofL trace_optionen 1 loc_lu_alias_name opt lib utmlu62 u62_adm tflL L trace_optionen 1 loc_lu_alias_name Beschreibung ton tof tfl Trace On Der Trace wird eingeschaltet Trace Off Der Trace wird ausgeschaltet Trace Flush Der Trace wird weitergeschaltet d h die aktuelle Trace Datei wird geschlossen und eine neue angelegt 62 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren trace_optionen Steuert die Art und Ausf hrlichkeit des Trace Folgende trace_optionen sind m glich Es k nnen auch mehrere Trace Optionen durch Komma getrennt angegeben werden in Der Instanz Trace wird ein aus bzw weitergeschaltet Wird diese Trace Option bei ton angegeben so wird der Instanz Trace mit dem ausf hrlichen Level in 2 eingeschaltet xap Der XAP TP Trace wird ein aus bzw weitergeschaltet in 1 Nur bei ton Der Instanz Trace wird mit dem niedrigsten Level eingeschaltet Es werden nur die f r einen Protokoll Trace erfor derlichen Trace Eintr ge geschrieben Zum Protokoll Trace siehe Seite 66 Dieses Trace Level ist im allgemeinen f r eine erste Fehlerdiagnose ausreichend in 2 Nur bei ton Der Instanz Trace wird mit dem ausf hrlichen Level eingeschaltet in 3 Nur bei ton Der Instanz Trace wird mit einer zus tzlichen Zeit messung fu
118. BS2000 OSD Security Control System Tabellenheft Zielgruppe Erfahrene SECOS Anwender openSM2 BS2000 OSD Software Monitor Band 1 Verwaltung und Bedienung Zielgruppe Anwender und Systembetreuung TIAM BS2000 OSD TRANSDATA Benutzerhandbuch Zielgruppe Nicht privilegierte BS2000 Anwender und Programmierer 386 U5461 J Z135 6 Literatur Unicode im BS2000 OSD bersichtshandbuch Zielgruppe Anwendungsprogrammierer und Systemverwalter die sich einen berblick verschaffen wollen welche Unicode Unterst tzung ihnen im BS2000 OSD geboten wird und welche BS2000 Komponenten sie dazu ben tigen VTSU BS2000 OSD TRANSDATA Virtual Terminal Support Benutzerhandbuch Zielgruppe Anwender der Zugriffsmethoden DCAM TIAM und UTM sowie System und Netzverwalter XHCS BS2000 OSD 8 bit Code und Unicode Unterstiitzung im BS2000 OSD Benutzerhandbuch Zielgruppe Anwender der Zugriffsmethoden DCAM TIAM und UTM sowie Systemverwalter Anwen der die von EHCS auf XHCS umstellen U5461 J Z135 6 387 Literatur Dokumentation zum Umfeld von UNIX Systemen CMX V6 0 Solaris Betrieb und Administration Benutzerhandbuch Zielgruppe Systemverwalter f r Solaris CMX V6 0 Unix Systeme Betrieb und Administration Benutzerhandbuch Zielgruppe Systemverwalter f r UNIX Systeme CMX V6 0 CMX Anwendungen programmieren Programmierhandbuch Zielgruppe Programmierer von Kommunikationsanwendungen auf UNIX System
119. C KCRN A lt Committed Forget CEB gt PEND FI Im Beispiel 6 sieht das 3 Teilprogramm ob IMS Commit oder Rollback gegeben hat Im Beispiel 5 erfahrt das Teilprogramm von Commit oder Rollback in IMS nichts mehr dies erfolgt allein unter Kontrolle vom UTM Systemcode U5461 J Z135 6 201 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 7 Synchroner Aufruf einer IMS Transaktion von openUTM mit Transaktionssicherung Rollback von openUTM IMS Anwendung UTM Anwendung APRO DM KCOF C KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten GU IOPCB ISRT IOPCB Daten gt MGET NT VGST 0 KCRN A PEND FR lt Backout Quittung gt 8 Synchroner Aufruf einer IMS Transaktion von openUTM mit Transaktionssicherung Rollback vom IMS Programm IMS Anwendung UTM Anwendung APRO DM KCOF C KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten GU IOPCB ISRT IOPCB ROLB FMH7 gt Fehlerdaten gt FMH7 CEB gt Rollback der UTM Transaktion 202 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren 5 2 6 Ablauf Beispiele mit CPI C Programmen 1 2 Synchroner Aufruf eines IMS CPI C Programms von openUTM ohne Transaktionssi cherung IMS Anwendung UTM Anwendung APRO DM KCOF B KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten Accept Receive_Data Receive_SEND Send_Data SRRCMIT lokaler Syncpoi
120. CESS POINT amp XPLTH fehlerhafte Lange amp XPRICT siehe Tabelle auf Seite 337 Assoziation abgelehnt a_assin amp ACPNT amp OSLPAP Grund amp XPRJCT Diese Meldung wird ausgegeben wenn der Aufbau einer Association von auBen abgelehnt wird Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPRICT siehe Tabelle auf Seite 337 Assoziation abgelehnt a_assin amp ACPNT Grund Partner unbekannt Partner Adresse Diese Meldung wird ausgegeben wenn der Aufbau einer Association von auBen abgelehnt wird weil der ferne Partner in der lokalen Anwendung nicht bekannt ist Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT U5461 J Z135 6 317 Meldungen des XAP TP Providers Meldungen von openUTM LU62 P006 Assoziation abgelehnt a_assin amp ACPNT amp OSLPAP Grund Falscher Application Context Name amp XPOOBID amp XP1OBID amp XP2OBID amp XP3O0BID amp XP4OBID amp XP5OBID amp XP6OBID amp XP7OBID amp XP8OBID XP9OBID Diese Meldung wird ausgegeben wenn der Aufbau einer Association von auBen abgelehnt wird Der Application Context Name f r den fernen Partner stimmt nicht mit dem in der lokalen Anwendung f r diesen Partner generierten Application Con text Namen berein Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POIN
121. CIN 92 Beenden von openUTM LU62 57 Beispiele CPI C Programme LU6 2 203 DL I Programm LU6 2 197 Belegte parallele Verbindung 60 Belegte Session 60 Benutzerkennung 82 150 Bidder 360 BIND 360 Bracket Protokoll 360 Cc CEMT SET CONNECTION NOTPENDING 40 Chain of RUs 221 225 360 Change Direction 111 219 CHNG Aufruf siehe IMS Aufrufe CICS 361 CICS Client 146 CICS Definitionen f r LU6 1 Transaktionen 216 f r LU6 1 Verbindung 209 f r LU6 2 Transaktionen 81 f r LU6 2 Verbindung 75 84 U5461 J Z135 6 395 Stichw rter CICS Makros 209 CICS Programmierung 120 Asynchron Auftr ge bei LU6 1 232 Auftraggeber bei LU6 1 220 Auftraggeber bei LU6 2 109 Auftragnehmer bei LU6 1 227 Auftragnehmer bei LU6 2 116 Beispiel f r LU6 1 231 233 Beispiel f r LU6 2 83 123 Kommandos f r LU6 1 220 232 Kommandos f r LU6 2 108 Kommandos siehe EXEC CICS Pseudo Dialog 250 256 Regeln f r LU6 1 218 Regeln f r LU6 2 120 Vergleich mit KDCS 121 230 Cluster Controller 361 COMM Makro 238 Commit 363 Committed 124 Communication Controller 361 Compare States 361 conffile 52 CONNECT 46 CONNECTION Name beiLU6 1 210 211 bei LU6 2 76 78 Contention Loser 361 Contention Winner 46 79 361 CONTWIN 46 Conversation 361 CPI C 151 361 CPI C Programmierung Vergleich mit KDCS 151 CPI RR 151 361 CMSERR 153 174 CMSPTR 153 CMSSL 151 CMSST 153 CTRL siehe KDCS Aufruf D Datenschutz 254 DEFINE CONNECTION 76 210
122. CONTEXT UDTSEC 27 APT 1 2 3 22 AEQ 1 23 ASS NAMES OSIC4 ASSOCIATIONS 15 6 CONNECT 2 7 CONTWIN 10 28 LTAC CICSUPS1 42 LPAP ACICS04 41 RTAC UPS1 9 TAC UCS1 gt 2 PROGRAM ucs11u62 90 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren UTM Anwendungsprogramm Adressierung im Auftraggeber Programm KCOP APRO KCOM DM KCRN CICSUPS1 42 KCPI gt A KCOF C KDCS nderungen bei Verwendung von openUTM unter BS2000 0SD Wird anstelle von openUTM unter UNIX Systemen openUTM unter BS2000 OSD verwen det so ndert sich das Generierungsbeispiel wie folgt openUTM LU62 Generierung ohne Verwendung von TNSX INSTANCE LOC LU ALIAS TO2CGEI4 19 LOC TSEL T SMP22804 36 LOC LISTENER PORT 22804 37 LOC APT 1 2 3 22 LOC AEQ 1 23 REM LU ALIAS CICST6 20 MODENAME MODDIS89 5 LU62 CODE EBCDIC 273 REM TSEL T SMP22800 29 REM LISTENER PORT 102 30 REM NSEL utmhost 33 REM APT 1 2 4 25 REM AEQ ld 26 APPL CONTEXT UDTSEC 27 ASSOCIATIONS 15 6 CONNECT 4 CONTWIN 5 28 OSITP CODE ASCII U5461 J Z135 6 91 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 TNSX Generierung SMP22800 u SMP22804 P Ss I P S S S A S S S m fT cf m m mM i RFC1006 123 45 67 89 PORT 102 T SM
123. CR_COMMIT_RI 31 CCR_COMMIT_RC 32 CCR_ROLLBACK_RI 33 CCR_ROLLBACK_RC 34 CCR_RECOVER_RI 35 CCR_RECOVER_RC 50 PDU_ANY 51 PDU_UASE_RI 330 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des XAP TP Providers P018 P019 XP1DIA Bedeutung XP2DIA 1 not supported parameter was received and skipped 2 received data truncated 4 required transfer syntax name missing in user data or not specified in AVX list error codes in amp XP2DIA 6 no transfer syntax name in user data though presentation negotiation was not completed 7 transfer syntax name encoded in user data not found in AVX list 10 invalid value in data structure 11 invalid object identifier in data structure 12 invalid length or count in data structure 13 invalid index in data structure EXTERNAL CHOICE 14 invalid value of ax_typtag in corresponding syntax table amp XP3DIA zugeh riger Index in der Syntaxtabelle FSM Protokollfehler amp ACPNT amp OSLPAP amp XPPTYP amp XPFSMN Diese Meldung wird ausgegeben wenn die Finite State Machine einen Fehler mel det Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPPTYP Typ des Service Protokollelements amp XPFSMN Name der Finite State Machine APDU enthaelt ungueltigen Wert amp ACPNT amp OSLPAP amp XPAPDU amp XP3INFO Diese Meldung wird ausgegeben w
124. CS und openUTM kann auf zwei Arten erfolgen Distributed Transaction Processing DTP LU6 1 Asynchronous Processing LU6 1 mit START und RETRIEVE Alle anderen Kopplungsm gichkeiten die von CICS angeboten werden k nnen nicht ver wendet werden z B Distributed Program Link Multiregion Operation Im folgenden soll ein grober berblick ber die Besonderheiten einer openUTM CICS Kommunikation vermittelt werden Regeln und Restriktionen bei CICS Programmierung Bei Erstellung von CICS Programmen sind folgende Gesichtspunkte zu ber cksichtigen 1 F r openUTM sind eine ferne CICS und eine ferne UTM Anwendung nicht unter scheidbar Mit anderen Worten openUTM wei nicht ob es sich beim fernen Vorgang um einen CICS oder einen UTM Vorgang handelt 2 Kommandos oder Kommandofolgen in CICS Programmen m ssen einem Aufruf oder einer Folge von Aufrufen an der KDCS Programmschnittstelle entsprechen damit sie mit UTM Vorg ngen kommunizieren k nnen 3 Am Ende einer CICS Transaktion Logical Unit of Work werden nicht alle sondern ein zelne ausgewahite Betriebsmittel gesichert Am Ende einer UTM Transaktion werden dagegen alle ge nderten Betriebsmittel gesichert Mit anderen Worten openUTM ar beitet voll transaktionsorientiert und eine UTM Sicherung ist unteilbar CICS Vorg n ge die eine bergreifende Transaktionssicherung voraussetzen m ssen deshalb die Dialog oder Asynchron Nachricht als gesichert PROTECTED behand
125. CT ATTACH PROCESS data area RECFM data area Ein von openUTM gesendeter FMH5 enth lt den CICS Transaktionscode PROCESS Option und Information ber das verwendete Nachrichtenformat In anderen Feldern siehe CICS for MVS ESA Application Programming Reference werden nach dem Aufruf keine Informationen geliefert PROCESS Option enth lt nach dem Aufruf den Transaktionscode wie er von open UTM an CICS im FMH5 gesendet wurde d h den RTAC der UTM Generierung RECFM Option siehe Seite 225 U5461 J Z135 6 227 CICS Kommandos f r CICS Auftragnehmer Vorg nge openUTM CICS Kopplung ber LU6 1 BUILD ATTACH Mit diesem Kommando wird vom CICS Auftragnehmer Vorgang ein ATTACH Header FMH5 erstellt in dem open UTM das Nachrichtenformat f r nachfolgende Nachrichten bekannt gemacht werden Das Kommando hat folgende Syntax EXEC CICS BUILD ATTACH ATTACHID name RECFM data area ATTACHID name definiert den Namen des ATTACH Headers Dieser Name wird beim SEND oder CONVERSE Kommando angegeben RECFM data area data area ist ein zwei Byte langes Feld das das Satzformat der von CICS gesen deten S tze enth lt x 01 Daten im VLVB Format x 04 Daten im Format Chain of RUs Andere Optionen siehe CICS for MVS ESA Application Programming Reference dieses Kommandos sind bei der Kopplung mit openUTM ohne Bedeutung SEND Mit dem SEND Kommando wird eine Dialogteilnachricht erstellt Das Kommand
126. Client PEND FI FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED CMSEND Daten Prepare gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT RequestCommit Committed gt Forget RR_OK Im Beispiel 13 sieht das 3 Teilprogramm ob CPI C Commit oder Rollback gegeben hat Im Beispiel 12 erf hrt das Teilprogramm von Commit oder Rollback in CPI C nichts mehr dies erfolgt allein unter Kontrolle vom UTM Systemcode U5461 J Z135 6 163 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 14 Keine Daten vom CPI C Anwendungsprogramm im UTM Anwendungsprogramm be n tigt und mit Transaktionssicherung gt INIT MGET Client APRO DM KCRN gt A KCOF C MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI FMH5 Daten Prepare gt CMACCP CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT lt RequestCommit Committed gt lt Forget RR_OK 164 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 15 Zwei Transaktionen in einem Vorgang erste Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND RE INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP
127. DEFINE SESSIONS 78 211 DEFINE TRANSACTION 81 216 217 Dependent LU 364 Destination Process Name 249 DFSLUEEO 197 Dialog 362 DISPLAY IMS Kommando 208 Distributed Program Link 146 362 Distributed Transaction Processing 108 218 362 DL 194 DL I COBOL Programm Beispiel 196 Dokumentation Wegweiser 14 DPN 238 249 255 Dump erzeugen 65 Dump Dateien 65 E EBCDIC 48 49 234 EDTNAME 238 Enterprise Extender 362 Exchange Log Name 59 EXEC CICS ALLOCATE 83 109 220 BUILD ATTACH 221 228 CPIC Aufruf CONNECT PROCESS 83 110 CMACCP 152 CONVERSE 112 117 224 229 CMALLC 151 EXTRACT ATTACH 225 227 CMCFMD 173 175 EXTRACT PROCESS 116 CMDEAL 152 FREE 115 118 CMINIT 151 ISSUE ABEND 113 117 CMRCV 152 ISSUE CONFIRMATION 113 117 CMSDT 153 ISSUE ERROR 113 117 CMSEND 152 ISSUE PREPARE 114 119 127 396 U5461 J Z135 6 Stichw rter ISSUE SIGNAL 115 118 LINK 146 RECEIVE 112 116 223 227 RETRIEVE 233 250 256 RETURN 119 226 229 SEND 111 116 222 228 START 232 250 256 SYNCPOINT 114 118 226 229 SYNCPOINT ROLLBACK 114 118 139 140 169 WAIT CONVID 115 118 External Call Interface 146 F Fehlerdiagnose 257 First speaker session 362 FMH 363 FMH4 234 363 FMH5 221 225 228 363 FMH6 235 249 255 363 FMH7 363 Formatnamen IMS mit LU6 2 197 Front end Transaction 363 Function Management Header 363 Functional Unit Commit 363 G Gateway Linux AIX Systeme mit IBM CS 31 LU6 1 Kopplung 34 Rechne
128. DM 301 302 303 Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber CCR Syntax fuer die OSI TP Partner Anwendung nicht vereinbart Der LU6 2 Partner hat eine Conversation mit Sync Level 2 zum TP amp TPNAME auf gebaut amp TPNAME bezeichnet also den UTM Transaktionscode Da der Applica tion Context UDTAC oder UDTDISAC konfiguriert wurde kann openUTM LU62 nicht wie angefordert einen OSI TP Dialog mit Functional Unit Commit zum OSI TP Partner aufbauen und lehnt deshalb die Conversation sofort wieder ab Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Restart der Kontrollinstanz ist noch nicht abgeschlossen Der LU6 2 Partner hat eine Conversation mit Sync Level 2 zum TP amp TPNAME auf gebaut amp TPNAME bezeichnet also den UTM Transaktionscode Da jedoch der Wiederanlauf von Transaktionen die von einem vorangegangenen Start von openUTM LU62 noch bestehen noch nicht abgeschlossen ist ist die XAP TP Kon trollinstanz noch nicht im geeigneten Zustand um neue OSI TP Dialoge mit Functional Unit Commit zu unterst tzen Daher weist u62_tp die Conversation sofort ab Dieser Fall kann auftreten wenn nach einem Absturz die Verbindung zum LU6 2 Partner wieder aufgebaut wurde die Verbindung zwischen openUTM LU62 und der UTM Anwendung aber noch nicht wieder hergestellt ist Ankommende Conversation TP Name amp TPNAME LU6 2 Seite ist Auftraggeber liefert Initialisierungsd
129. DM KCPI gt A MPUT NE KCRN gt A PEND RE FMH5 Daten SRQ gt GU IO PCB ISRT RETURN lt Daten SRSP lt SRQ INIT MGET NT KCRN gt A MPUT NE Client PEND FI lt SRSP gt SRQ Syncpoint Request SRSP Syncpoint Response 246 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 1 IMS Programmierung bei Kopplung mit openUTM Die zweite Variante unterscheidet sich von der ersten in der Logik der Transaktionssiche rung In der ersten Variante besteht der gesamte Ablauf aus einer einzigen Transaktion In der zweiten Variante geh ren eventuelle Datenbank nderungen nach dem MGET KCRN gt A nicht zur selben Transaktion wie die auf IMS Seite durchgef hrten Datenbank nderungen Sollen auf beiden Seiten Datenbank nderungen durchgef hrt werden so muss die zweite Variante gew hlt werden Kommt es bei der ersten Variante nach dem MGET KCRN gt A zu einem R cksetzen der Transaktion auf UTM Seite z B durch PEND ER so ist IMS nicht mehr in der Lage die Datenbank nderungen zur ckzusetzen 7 4 5 Beispiele f r den Austausch von Asynchron Auftr gen 1 Start eines UTM Asynchron Auftrags aus einem IMS Anwendungsprogramm ISRT Alt PCB RETURN FMH6 Daten SRQ gt lt SRSP INIT FGET PEND FI 2 Start eines IMS Asynchron Auftrags aus einem UTM Anwendungsprogramm INIT APRO AM KCPI gt A FPUT NE KCRN gt A PEND FI FMH6 Daten S
130. DOORS und Administratoren die Masken konvertieren und diese bereitstellen 384 U5461 J Z135 6 Literatur HIPLEX AF BS2000 OSD Hochverfiigbarkeit von Anwendungen in BS2000 OSD Produkthandbuch Zielgruppe Systemverwalter und Organisatoren in Rechenzentren IMON BS2000 OSD Installationsmonitor Benutzerhandbuch Zielgruppe Systembetreuung des Betriebssystems BS2000 OSD MT9750 MS Windows 9750 Emulation unter Windows Produkthandbuch Zielgruppe PC Benuizer der mit Hilfe des Produktes MT9750 mit Anwendungen auf einem BS2000 Host kommunizieren will OMNIS OMNIS MENU TRANSDATA BS2000 Funktionen und Kommandos Benutzerhandbuch Zielgruppe OMNIS Administrator und OMNIS Anwender OMNIS OMNIS MENU TRANSDATA BS2000 Administration und Programmierung Benutzerhandbuch Zielgruppe OMNIS Administrator und Programmierer OMNIS MENU TRANSDATA BS2000 OSD Benutzerhandbuch Zielgruppe OMNIS MENU Benutzer und OMNIS MENU Administrator U5461 J Z135 6 385 Literatur OSS BS2000 OSD OSI Session Service User Guide Zielgruppe OSI TP Anwender RSO BS2000 OSD Remote SPOOL Output Benutzerhandbuch Zielgruppe Nichtprivilegierte Benutzer RSO Gerateverwalter SPOOL Verwalter und Systembetreuer des BS2000 OSD SECOS BS2000 OSD Security Control System Benutzerhandbuch Zielgruppe BS2000 Systemverwalter und BS2000 Anwender die den erweiterten Zugriffsschutz f r Dateien nutzen SECOS
131. Dabei werden Produkte unterschiedlicher Hersteller erw hnt IBM Communications Server ist ein Produkt der Firma IBM und erbringt die Funktionen der SNA Basis Software SNAP IX ist ein Produkt der Firma Data Connection Limited und erbringt die Funktio nen der SNA Basis Software TRANSIT SERVER TRANSIT CLIENT und TRANSIT CPIC sind Produkte von Fujitsu Siemens Computers und erbringen die Funktionen der SNA Basis Software CMX PCMX und BCAM sind Produkte von Fujitsu Siemens Computers CICS IMS TxSeries und VTAM sind Produkte der Firma IBM Generell gilt dass die Namen der IBM Produkte in manchen Produktversionen leicht ab weichen k nnen 24 U5461 J Z135 6 Kopplung mit IBM Systemen Direkte LU6 2 Kopplung ber TRANSIT auf Solaris 2 1 Direkte LU6 2 Kopplung ber TRANSIT auf Solaris Die folgende Kopplungsm glichkeit kann eingesetzt werden wenn die UTM Anwendung auf einem Solaris Rechner l uft der direkt an das SNA Netz angebunden ist Solaris Rechner openUTM CMX openUTM LU62 TRANSIT CPIC TRANSIT SERVER IBM Rechner CICS oder IMS oder TXSeries SNA Basis Software z B VTAM SNA ber Ethernet Direkte LU6 2 Kopplung mit openUTM auf Solaris und Einsatz von TRANSIT Der Solaris Rechner muss als PU vom Typ 2 1 im SNA Netz generiert sein Im Bild ist eine SNA Kopplung ber Ethernet dargestellt Zu anderen Kopplungsm glichk
132. Daten Diese Meldung wird zus tzlich zu Meldung 392 bzw 393 ausgegeben wenn die TP_U_ABORT indication Log Daten enth lt Da diese Daten jedoch nicht an den LU6 2 Partner weitergereicht werden k nnen werden sie in hexadezimaler Schreibweise in der Datei prot uname protokolliert und danach verworfen Statistik Aktiv aufgebaute ungesicherte Conversations amp NA1 Aktiv aufgebaute gesicherte Conversations amp NA2 Passiv aufgebaute ungesicherte Conversations amp NP1 Passiv aufgebaute gesicherte Conversations amp NP2 Gesamtzahl aller bisherigen Conversations amp N3 Diese Meldung wird jede Stunde und bei der Beendigung von u62_tp ausgegeben Sie gibt Auskunft dar ber wieviele Transaktionen gelaufen sind Meldungen der Komponente TM 400 401 Startphase erfolgreich abgeschlossen Das Programm u62_tp hat die Startphase erfolgreich abgeschlossen Erst nach dem diese Meldung ausgegeben wurde k nnen Transaktionen gestartet werden Warmstart amp ANZAHL Transaktionen m ssen resynchronisiert werden Beim vorhergehenden Beenden von open UTM LU62 waren noch amp ANZAHL Trans aktionen in undefiniertem Zustand Bevor neue Transaktionen gestartet werden k nnen m ssen zun chst die offenen Transaktionen resynchronisiert werden Die offenen Transaktionen werden genauer in der nachfolgenden Meldung 402 beschrieben U5461 J Z135 6 301 Meldungen des Programms u62_tp Meldungen von openUTM LU62 402 Info
133. Definition Der CICS Systemverwalter hat mehrere M glichkeiten zur Definition von Connections und Sessions z B RDO Resource Definition Online mittels CEDA DFHCSDUP oder Makros APPLID In der System Initialization Table SIT muss der Name der CICS Anwendung angegeben werden DFHSIT APPLID cics_netname 1 8 Zeichen langer Name mit dem der SNA Netzname f r die CICS Anwendung festgelegt wird Dieser Name muss mit den Definitionen in VTAM VBUILD TY PE APPL abgestimmt sein U5461 J Z135 6 75 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 DEFINE CONNECTION Mit dieser Definition wird das ferne System in diesem Fall die Stellvertreter LU in openUTM LU62 beschrieben DEFINE CONNECTIO connection_name GROUP group_name NETNAME netname ACCESSMETHOD VTAM PROTOCOL APPC SINGLESESS NO DATASTREA USER RECORDFORMAT U AUTOCONNECT NO YES ALL INSERVICE YES ATTACHSEC LOCAL IDENTIFY VERIFY MIXIDPE Die Operanden haben folgende Bedeutung CONNECTION connection_name 1 4 Zeichen langer Name zur Bezeichnung der UTM Anwendung Dieser Name existiert nur innerhalb von CICS Er muss in den CICS Programmen beim ALLOCATE im Parameter SYSID angegeben werden wenn das CICS Programm einen UTM Transaktionscode aufrufen will GROUP group_name 1 8 Zeichen langer Name Der CICS Systemverwalter muss diesen Namen verge ben Der Name kommt nur in den CICS Definitionen vor NETNAME netname
134. Diagnose Information in den Initialisierungsdaten von AP_TP_BEGIN_DIALOGUE_CNF Oxhhhh d d wobei hhhh Hexadezimal Werte und d d die entsprechenden Dezimalwerte darstel len Bei UTM als OSI TP Partner enthalten die Initialisierungsdaten genauere Informa tionen Uber den Grund der Ablehnung des Dialogs Der erste Wert zeigt an ob es sich um einen transienten 1 oder permanenten 2 Fehler handelt Der zweite Wert gibt den genauen Ablehnungsgrund an Die Bedeutung dieser Werte ist dem Handbuch openUTM V5 3 Meldungen Test und Diagnose in BS2000 OSD zu entnehmen Beschreibung DIAS in Meldung K119 bei DIA1 2 Protokollverstoss AP_TP_ACCEPT in AP_TP_BEGIN_DIALOGUE_CNF empfangen TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Der OSI TP Partner hat den ankommenden OSI TP Dialog positiv quittiert obwohl openUTM LUB2 keine explizite Quittung beim OSI TP Dialogaufbau angefordert hat Dieser Protokollversto f hrt dann zum Abbruch des OSI TP Dialogs und der Conversation zum LU6 2 Partner Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Protokollverstoss AP_TP_BEGIN_TRANSACTION_IND erhalten TP Name amp TPNAME LU6 2 Seite ist Auftraggeber openUTM LU62 hat vom OSI TP Partner ein BEGIN_TRANSACTION Primitiv er halten Dies ist ein schwerer Versto gegen das OSI TP Protokoll Folglich bricht openUTM LU62 den OSI TP Dialog und die Conversation zum LU6 2 Partner ab Diese Meldung kann nur auftrete
135. Dialog 251 OSI LPAP Anweisung 45 47 OSI TP Dialog 362 OSITP CODE 49 P Parallele Sessions 367 bei LU6 1 212 240 bei LU6 2 76 Parallele Verbindungen 45 belegte 60 Partner UTM Anwendung TCP Portnummer 50 Passwort 82 IMS 183 U5461 J Z135 6 399 Stichw rter PEND siehe KDCS Aufruf Physical Unit 367 PLU 367 Primary LU 212 367 Primary Resource Name 249 Principal Facility 367 PRN 249 Programmbeispiel openUTM CICS asynchron 233 openUTM CICS ber LU6 1 231 openUTM CICS ber LU6 2 123 openUTM IMS 246 Protokoll Trace 66 Pseudo Dialog 249 PU 367 R RACF 82 IMS 183 RDPN 249 Readme Dateien 19 Recovery 40 Registrierungseditor 57 REM AE 49 REM AEQ 49 REM APT 50 REM LISTENER PORT 50 REM LU ALIAS 50 REM NSEL 50 REM TSEL 50 Remote LU 50 Request Commit 124 Request Unit 368 Resource Definition Online 209 Resync 368 Return Destination Process Name 249 Return Primary Resource Name 249 RETURN Aufruf siehe IMS Aufrufe RNETNAME 209 238 ROLL Aufruf siehe IMS Aufrufe ROLLB Aufruf siehe IMS Aufrufe RPRN 249 RSES 211 240 RTAC 216 227 243 RU 368 RU Size 79 212 368 S Schreibmaschinenschrift 21 Secondary LU 212 367 Security 77 Security Varianten IMS 183 Senderecht 111 219 222 Sense Data 259 Service Windows Systeme 57 SESCHA Anweisung 212 234 238 255 Session 368 belegte 60 Sessionanzahl 78 Sessionaufbau 242 Sessionfreigabe 218 SESSNAME 211 Side Information IMS 180 IMS Beispiel 185 S
136. EIT Sekunden Diese Meldung wird ausgegeben wenn w hrend der Resynchronisierung einer Transaktion ein Fehler z B ein Verbindungsabbruch auftritt und die Resynchroni sierung sp ter nochmals wiederholt werden muss Transaktion wurde erfolgreich resynchronisiert TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Eine durch Verbindungsverlust oder sonstige Fehler abgebrochene Transaktion wurde erfolgreich resynchronisiert Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 LU6 2 Partner meldet heuristischen Mix TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Der LU6 2 Partner hat die Transaktion z B nach einem Verbindungsverlust eigen st ndig beendet ohne auf die UTM Anwendung zu warten Die Transaktion ist damit inkonsistent Datenbank nderungen auf UTM Seite und auf LU6 2 Seite die durch die Transaktion koordiniert werden sollten wurden fehlerhaft ausgef hrt Beispiels weise wurde die geforderte Datenbank nderung auf LU6 2 Seite ausgef hrt auf UTM Seite aber nicht Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 blicherweise sind in diesem Fall manuelle Eingriff
137. FT130 MFT131 M Der Returncode von PutElement war ungleich DM_OK MFT132 MFT133 M Der Returncode von CopyElement war ungleich DM_OK MFT134 M Der Returncode von PutElement war ungleich DM_OK MFT135 MFT138 M Die Funktion PutElement hat einen Returncode ungleich DM_OK MFT139 geliefert MFT141 M Die Funktion PutElement hat einen Returncode ungleich DM_OK geliefert U5461 J Z135 6 271 Meldungen des Programms u62_tp Meldungen von openUTM LU62 REASON Grp Ursache MFT142 M Die Funktion CopyElement hat einen Returncode ungleich DM_OK geliefert MFT147 M Die Funktion PutElement hat einen Returncode ungleich DM_OK MFT151 geliefert MFTPO3 M Der Returncode von PutElement war ungleich DM_OK MFTPO4 Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFTPO5 M Der Returncode von PutElement war ungleich DM_OK MFTPO6 MFTPO7 M Der Returncode von SetTimer war ungleich TI_OK MFTP10 M Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFTP11 M Der Returncode von RequestBuffer war ungleich LB_OK MFTP12 M bis Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFTP19 MFTP24 NMTEOO M Modul KCOCOHF Funktion NewMemTabEntry Die Funktion RequestBuffer lieferte den Returncode LB_NOMEM NMTEO2 M Modul KCOCOHF Funktion NewMemTabEntry Der Makro mGetBufferSpace lieferte den Returncode LB_NOMEM PCTROO M Mod
138. FUJITSU THE POSSIBILITIES ARE INFINITE a Home Support Aboutus Where to buy Manuals Online manuals v BUSINESS Products If you are looking for Fujitsu Technology Solutions product manuals you are in the right spot Simply choose your product and download the document in pdf format Industry standard servers BS2000 OSD mainframes UNIX OS based servers QUICK ACCESS Mission critical IA64 servers Storage Solutions Search by product E IT infrastructures solutions Software Deskbound devices Mobile devices The Quick Access search locates all available documents for your selected product If JavaScripta has been enabled suggestions will be offered as you type Use the mouse to browse the results left click to insert the highlighted suggestion more Professional accessories amp ONLINE SHOP mainboards Displays amp projectors Most of the manuals are also available in printed form To order your copies please visit our Manual Shop at http manualshop ts fujitsu com HOME amp HOME OFFICE gt MANUAL SHOP COGNITAS The documents on the following internet pages have been created by our partner cognitas Gesellschaft cognitas logo 2 fAY r Technik Dokumentation mbH ADOBE READER adobe logo In order to view and print the online document in pdf format Adobe Reader is required version 5 or later To download the latest version of Adobe Reader click here 1999 2009
139. Fujitsu Technology Solutions Imprint Privacy policy Terms ofuse Contact Support http manuals ts fujitsu com index php cookie 13 05 2009 09 49 34 Fujitsu Technology Solutions FUJITSU THE POSSIBILITIES ARE INFINITE BI Home Support Aboutus Where to buy MANUALS gt BUSINESS Products Industry standard servers BS2000 OSD mainframes UNIX OS based servers Mission critical IA64 servers Storage Solutions IT infrastructures solutions Software Cluster Technology Communications and Networking SELECT Compiler Document Printing and Spools Management Storage software Transaction processing and Databases Deskbound devices Mobile devices Professional accessories amp mainboards Displays amp projectors HOME amp HOME OFFICE MANUAL SHOP gt 1999 2009 Fujitsu Technology Solutions Imprint Privacy policy Terms ofuse Contact Support http manuals ts fujitsu com index php id 9864 9871 13 05 2009 09 50 51
140. I ACBNAME FOR APPC PPC YES LOSS ALL OGMOD APPCMODE INWNL 5 ESLIM 10 DETAB LOGMODES RSESS YES C B ar VDZ JJIJID gt D gt S 0 A ECACPT NONE RBEXIT YES SYNCLVL SYNCPT Dabei ist IMSAPPL1 die APPLID von IMS APPCMODE ist in diesem Beispiel der MODE Name Mit DSESLIM gibt man die Maximalzahl von LU6 2 Sessions an mit DMINWNL die Minimalzahl von Contention Winner Sessions Mit SECACPT wird gesteuert ob die LU6 2 Partnerprogramme beim Aufbau einer Conversation eine Userid und eventuell ein Pass wort mitgeben m ssen SYNCLVL SYNCPT wird ben tigt fur 2 Phase Commit Kommuni kation Zudem muss die APPLID auch bei APPC MVS bekannt gegeben werden Dies geschieht mit einer LUADD Anweisung in der SYS1 PARMLIB APPCPMxx LUADD ACBNAMECIMSAPPL1 BASE SCHEDCIMSREG TPDATA SYS1 APPCTP Dabei ist IMSAPPL1 wiederum die APPLID von IMS Mit dem Parameter SCHED wird die IMS Region angegeben Der bei TPDATA angegebene Wert ist der Name der Datei in der die TP_Profile Definitionen enthalten sind ica Die IMS Systemdefinition wird mit einer Reihe von Assembler Makros festgelegt Anderun gen der Systemdefinition zur Laufzeit sind m glich ber das Zusatzprodukt ETO Extended Terminal Option 178 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren 5 1 3 Definition von IMS Transaktionen DL I muss als ein API definiert werden IMS Transaktionscodes die mit DL I reali
141. IBM Communications Server for z OS TRANSIT unterst tzt kein Enterprise Extender First speaker session Synonym f r contention winner Gegenteil bidder 362 U5461 J Z135 6 Fachw rter Front end Transaction Im CICS Sprachgebrauch ein Anwendungsprogramm das ein anderes mittels LU6 1 oder LU6 2 aufruft Bei openUTM wird statt dessen der Begriff Auftragge ber Vorgang verwendet Function Management Header FMH Function Management Header enthalten Informationen zur Kommunikation und werden als Header vor den Nettodaten in einer Request Unit RU gesendet Bei LU6 1 gibt es folgende FMHs FMH4 Der FMH4 kann zu Beginn einer Nachricht gesendet werden und ent h lt dann zus tzliche Informationen f r die nachfolgende Nachricht openUTM sendet einen FMH4 wenn beim MPUT KCDF ungleich 0 oder KCMF ungleich Leerzeichen angegeben wurde FMH5 Attach Header Der FMH5 wird am Anfang einer Bracket gesendet und beginnt eine Auftraggeber Auftragnehmer Beziehung Er enth lt den Transakti onscode und den Indikator f r das Datenformat VLVB oder chain of RUs Er kann auch am Anfang einer Antwortnachricht stehen und enth lt dann nur den Indikator f r das Datenformat FMH6 Scheduler FMH Der FMH6 wird gesendet beim bertragen eines Asynchronauftrages FMH7 Error Description Der FMH7 sendet dem Partner eine Fehlermel dung Bei LU6 2 gibt es folgende FMHs FMH5 Attach Header Der FMH5 wird am Anfang einer Conversat
142. ICS nichts mehr dies erfolgt allein unter Kontrolle vom UTM Systemcode 134 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 14 Keine Daten vom CICS Anwendungsprogramm im UTM Anwendungsprogramm ben tigt und mit Transaktionssicherung Wenn es von der Ablauflogik her nicht erforderlich ist dass das aufgerufene CICS Anwen dungsprogramm dem UTM Anwendungsprogramm Daten zur cksendet so kann die Kom munikation wie im folgenden Beispiel einfacher programmiert werden gt INIT MGET Client APRO DM KCRN gt A KCOF C MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI lt FMH5 Datent Prepare gt RECEIVE STATE SYNCFREE SYNCPOINT lt RequestCommit Committed gt lt Forget NORMAL RETURN U5461 J Z135 6 135 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 15 Zwei Transaktionen in einem Vorgang erste Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND RE INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI lt FMH5 Daten Prepare gt RECEIVE STATECSYNCSEND SYNCPOINT RequestCommit Committed gt Forget
143. ICS und openUTM LU62 konfiguriert werden Siehe weiter unten das vollstandige Generierungsbeispiel SNAP IX Generierung f r openUTM CICS Sessions Bei Verwendung von SNAP IX muss in diesem Produkt zum einen die SNA Verbindung zwischen dem UNIX System und dem SNA Host konfiguriert werden Zum anderen muss dort auch die LU6 2 Verbindung zwischen CICS und openUTM LU62 konfiguriert werden Siehe weiter unten das vollst ndige Generierungsbeispiel Generierung des IBM Communications Server f r openUTM CICS Sessions Bei Verwendung des IBM Communications Server muss in diesem Produkt zum einen die SNA Verbindung zwischen dem UNIX Windows System und dem SNA Host konfiguriert werden Zum anderen muss dort auch die LU6 2 Verbindung zwischen CICS und openUTM LU62 konfiguriert werden Siehe weiter unten das vollst ndige Generierungsbei spiel openUTM LU62 Generierung Die openUTM LU62 Generierung ist ausf hrlich im vorhergehenden Kapitel beschrieben Zum Abgleich der Generierungsparameter mit den anderen Generierungen siehe weiter unten das vollst ndige Generierungsbeispiel 80 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren 4 1 7 TNSX Generierung Auf dem Rechner auf dem openUTM LU62 l uft m ssen die TCP IP Adress Informatio nen f r die Kommunikation zur UTM Anwendung entweder in den TNSX Transport Name Server UNIX Systems oder direkt in die openUTM LUB62 eingetragen werden Die Adress I
144. IDEINFO 180 SLU 367 SNA 369 sna_rc 57 SNAP IX als Gateway auf Solaris 30 Solaris 26 Windows Systeme 28 Solaris als Gateway f r LU6 1 Kopplung 34 direkte LU6 1 Kopplung 33 LU6 2 Kopplung ber SNAP IX 26 LU6 2 Kopplung ber TRANSIT 25 SNAP IX Gateway f r LU6 2 Kopplung 30 TRANSIT Gateway f r LU6 2 Kopplung 29 Sprache 263 SRRBACK 151 168 SRRCMIT 151 SSCP 369 Standard IMS Transaktionen LU6 2 204 Starten von openUTM LU62 55 400 U5461 J Z135 6 Stichw rter status h 58 Statusanzeige 58 Stellvertreter AE 46 Transportselektor 47 Stellvertreter Konzept 35 Stellvertreter LU 47 TCP Portnummer 47 step 65 SUBPOOL Makro 240 Sync point initiator 364 Sync Level 110 116 369 Sync Point 369 Synclog Datei 40 SYSID 76 109 210 220 232 System Initialization Table 75 209 Systemstart 57 T TAC Anweisung 217 TCP Portnummer 47 50 TERMINAL Makro 239 TH 370 TNSX 46 49 81 90 92 TNSX Generierung IMS Beispiel f r LU6 2 192 TP 370 TP Name 370 TP_Profile Definition 184 Trace auswerten 64 Dateien 64 einschalten 62 Level 55 63 Trace Dateien Anzahl ndern 64 TRANSACT Makro 243 Transaction Program 370 Transaktions Recovery 40 Transaktionscode IMS 179 Transaktionsstatus 123 TRANSIT als Gateway auf Solaris 29 als LU6 1 Gateway 34 LU6 1 Kopplung 33 TRANSIT CLIENT Generierung openUTM CICS Kopplung 214 Generierung openUTM IMS Kopplung 242 243 Kopplungsbeispiel 33 TRANSIT CPIC 37 Kopplungs
145. IT SER VER sollte er mit dem Parameter SESS MAX in der zugeh rigen XMODE Anwei sung der TRANSIT Konfigurierung bereinstimmen Bei Verwendung von SNAP IX oder des IBM Communications Server sollte max mit dem Session Limit in der Mode Definition des IBM Communications Server bereinstimmen 78 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren Mit max2 wird die Maximalzahl von Sessions festgelegt bei denen die CICS Seite Contention Winner ist Bei Verwendung von TRANSIT SERVER sollte er mit dem Parameter SESS LOS in der zugeh rigen XMODE Anweisung der TRANSIT Kon figurierung bereinstimmen Bei Verwendung von SNAP IX oder des IBM Commu nications Server muss er nicht mit dessen Konfiguration abgestimmt werden Wenn die Maximalwerte von CICS und LU6 2 Basis Software nicht bereinstim men einigen sich die Systeme auf den niedrigeren Wert SENDSIZE ru_size RECEIVESIZE ru_size Damit wird die maximale RU Request Unit Size f r die LU6 2 Kommunikation zwi schen CICS und openUTM LU62 festgelegt Es sollte der Standardwert 4096 verwendet werden Kleinere RUs f hren zu h he rer Netzbelastung Die Werte f r SENDSIZE und RECEIVESIZE sollten gleich ge w hlt werden Der Wert sollte dem Wert im MODE Makro von VTAM entsprechen Bei Verwen dung von TRANSIT SERVER sollte er mit dem dort konfigurierten Wert SRU MAX und RRU MAX bereinstimmen Bei Verwendung von SNAP IX oder des IBM Communications Serv
146. IVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND LAST CONVID SYNCPOINT FMH5 Datent RequestCommit gt lt Committed NORMAL SEND Client PEN RETURN INIT FGET PEND FI openUTM sendet die Quittungsnachricht sofort nachdem es den Asynchron Auftrag erhal ten und gesichert hat Je nach Verf gbarkeit von Systemressourcen kann es bis zur Aus f hrung des Asynchronauftrags einige Zeit dauern Die Verwendung von EXEC CICS START zum Starten eines Asynchron Vorgangs ist bei LU6 2 nicht m glich U5461 J Z135 6 131 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 11 Ohne Transaktionssicherung gt RECEIVE Client ALLOCAT CONNECT PROCESS CONVID SYNCLEVEL 1 SEND LAST CONFIRM CONVID m FMH5 Daten gt lt Quittung NORMAL SEND Client Sees RETURN INIT FGET PEND FI Der Verzicht auf Transaktionssicherung bringt fur die Anwendungsprogramme folgende Nachteile Das Absenden der Asynchron Nachricht im CICS Programm kann nicht ohne weiteres mit anderen Ablaufen im Anwendungsprogramm gekoppelt werden Es kann also z B vorkommen dass die Asynchron Nachricht trotz eines gescheiterten lokalen Daten bank Updates an die UTM Anwendung gesendet wird Wenn die Quittung aufgrund eines Kommunikationsfehlers verloren geht wird die Asyn chron Nachricht eventuell mehrmals an die UTM Anwendung gesendet
147. Kern Eine ausf hrliche Beschreibung des openUTM Gateway finden Sie im Handbuch TRANSIT CLIENT Eine ausf hrliche Beschreibung der verschiedenen Kopplungsarten zwischen TRANSIT SERVER und dem IBM System finden Sie im Handbuch TRANSIT SERVER Bei einer Kopplung openUTM mit CICS werden folgende Komponenten durchlaufen openUTM CMX UTMGW1 TRANSIT SERVER CMX CCP NCP VTAM CICS Bei manchen Kopplungsarten entfallen CMX und CCP zwischen TRANSIT SERVER und NCP VTAM F r alle diese Komponenten m ssen Definitionen gemacht werden Die Abh ngigkeit zwischen openUTM und CICS wurde im vorigen Kapitel beschrieben Im folgenden Beispiel wird grob auf die Abh ngigkeiten bei den UNIX Definitionen eingegan gen Das Beispiel gilt f r eine Session wobei openUTM und UTMGW1 in einem Rechner laufen 214 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 TRANSIT Generierung f r open UTM CICS Sessions UTM Generierung LPAP CICSP LNETNAME UTMMCHP RNETNAME CICSCGK BCAMAPPL utmx1 CON cicsxl BCAMAPPL utmx1 LPAP CI CSP UTMGW1 gt APPLID CICSCGK INS cicsxl TNS Konfiguration r r r r art a4 Amt At obaler Na obaler Na obaler Na obaler Na UTMGW1 UTM TRANSIT e cicsxl 4 e utmx e sdIc IBM Host e ibmhost 1 eq VTAM NCP Generierung gt LI gt RTNS utmx1 gt LUNAME 1u0gw
148. Kommunikation verwendete MODE Name muss in VTAM definiert wer den Beispiel f r die Definition eines MODE Namens APPCMODE MODEENT LOGMODE APPCMODE RUSIZES X 8989 PSNDPAC X 00 SRCVPAC X 00 SSNDPAC X 01 Mit RUSIZES wird die maximale RU Size in Sende und Empfangsrichtung festgelegt Die Codierung erfolgt in 2 Hex Ziffern X abab Die tats chliche RUSIZE berechnet sich dann mit der Formel n a 2b Die Werte bei PSNDPAC SRCVPAC SSNDPAC beeinflussen den Pacing Count U5461 J Z135 6 181 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 Beispiel f r die VTAM Definition von Partner PU und Partner LU PO2CG3 PU ADDR C1 DISCNT NO DLOGMOD SNX32702 WITH QUERY IDBLK 017 IDBLK FOR IBM 3174 IDNUM 20003 ISTATUS ACTIVE MAXDATA 1033 MAXOUT 7 MAXPATH 2 MODETAB MOD3270 LOGMODE TABLE FOR REMOTE 3270 PACING 0 PUTYPE 2 SSCPFM USSSCS USSTAB USSSCS VPAC ING 0 FF F FF F F F F OF APPCLUX LU LOCADDR 0 INDEPENDENT LU USSTAB USSSCS ACF VTAM USS TABLE DLOGMOD APPCMODE ACF VTAM DEFAULT LOGMODE MODETAB LOGMODES LOGMODE TABLE RESSCB 4 RESERVE 4 SCB S FOR THIS LU PACING 3 VPACING 2 SSCPFM FSS Hr tr Hr Beispiel f r die Definition eines mit Enterprise Extender angebundenen Partnersystems ohne Definition der LUs SMNEEA2 VBUILD TYPE SWNET PUEEAL PU IDBLK 003 IDNUM 00002 MAXPATH 5 MAXDATA 256 ADDR 01 CPNAME MCHOOXYC CPCP YES
149. Kopplung generieren Side Information in IMS CNTL APPCSI EXEC PGM ATBSDFMU SYSPRINT DD SY SOUT SYSSDLIB DD DSN SYS1 APPCSI DISP SHR SYSSDOUT DD SY SOUT SYSIN DD DATA DLM X X SIDELETE DESTNAME DESTJW1 STADD DESTNAME DESTJW1 TPNAME DATAECHO ODENAME APPCHOST PARTNER_LU P390 IMSJ XX LTERM Definition in PROCLIB DFS62DTI A LTERMJW1 SIDE DESTJW1 SYNCLEVEL N CONVTYPE M Definition der IMS LU in PARMLIB APPCPM 1A LUADD ACBNAME MVSLUO1 BASE TPDATA SYS1 APPCTP LUADD ACBNAME IMSA BASE SCHED IVP1 TPDATA SYS1 APPCTP SIDEINFO DATASET SYS1 APPCSI VTAM Generierung Start Options SSCPNAME P390SSCP NETID P390 Switched Major Node Definition in VTAMLST SWXCAEE SWXCA1A VBUILD TYPE SWNET MAXNO 256 MAXGRP 256 SWIA13A PU IDBLK 05D IDNUM 25129 MAXPATH 5 MAXDATA 256 ADDR 01 CPNAME MHPBO2GC PCP YES HPR YES UTYPE 2 APADDR 4 gt PADDR 111 22 33 233 RPNM GPP390 PATH13A PATH DH nun U5461 J Z135 6 185 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 Major Node Definition f r Enterprise Extender in VTAMLST XCAEE1 XCAEEEl VBUILD TYPE XCA PORTIA PORT MEDIUM HPRIP IPPORT 12000 IPTOS 20 40 80 C0 C0 LIVTIME 10 SROTIME 15 SRQRETRY 3 SAPADDR 4 PP390 GROUP DIAL YES ANSWER ON ISTATUS ACTIVE CALL INOUT DYNPU YES IPADDR 111 22 33 244 ep LNEEO1 LINE PUEEO1 PU LNEEO2 LINE PUEEO2 PU APPL Defi
150. LLING_AEQ_TOO_LONG Bei der Association Indication wird f r den Application Entity Qualifier eine L nge an gegeben die openUTM nicht unterst tzt 4 CALLED_APT_TOO_LONG Der gerufene Application Process Title ist l nger als von openUTM unterst tzt 5 CALLED_AEQ_TOO_LONG Der gerufene Application Entity Qualifier ist l nger als von openUTM unterst tzt 6 CONTEXT_DEFINITION_LIST_TOO_LONG Bei der Association Indication werden mehr abstrakte Syntaxen mitgegeben als openUTM unterst tzt U5461 J Z135 6 337 Insert XPRJCT Meldungen von openUTM LU62 XPRJCT Bedeutung 7 CONTEXT_RESULT_LIST_TOO_LONG Die beim Associationsaufbau Association indication bzw confirmation mitgegebene Liste der unterst tzten abstrakten Syntaxen enth lt mehr Elemente als von openUTM unterst tzt ADDRESS_NO_PSAP_INFO Die bei Association indication bzw confirmation mitgegebene Adresse enth lt keine Informationen zum PSAP 10 ADDRESS_NO_INFO_VERS_0_PSAP Die bei Association indication bzw confirmation mitgegebene Adresse enthalt fur die PSAP Information eine falsche Version 11 ADDRESS_INVALID_P_SEL_LENGTH Die bei Association indication bzw confirmation mitgegebene Adresse enth lt f r den Presentation Selektor eine ung ltige Lange 12 ADDRESS_NO_SSAPINFO Die bei Association indication bzw confirmation mitgegebene Adresse enthalt keine Information zum SSAP 13 ADDRESS_NO_INFOVERS_0_SS
151. LOCATE CONNECT PROCESS CONVERSE EXTRACT ATTRIBUTES EXTRACT PROCESS FREE ISSUE ABEND ISSUE CONFIRMATION ISSUE ERROR ISSUE PREPARE ISSUE SIGNAL RECEIVE SEND SYNCPOINT SYNCPOINT ROLLBACK WAIT CONVID Bei vielen dieser Kommandos gibt es mehrere Varianten In den CICS Handb chern ist die LU6 2 Variante dann immer mit APPC bezeichnet z B SEND APPC Bei openUTM stehen hnlich wie bei CICS mehrere Programmschnittstellen zur Auswahl Die folgende Beschreibung geht meist davon aus dass die UTM Anwendungen mittels KDCS programmiert sind Es wird weiter unten aber auch auf CPI C eingegangen 108 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 4 2 1 CICS Kommandos f r CICS Auftraggeber Vorg nge ALLOCATE Mit diesem Kommando versucht ein CICS Auftraggeber Vorgang eine Session f r einen Auftragnehmer Vorgang zu belegen Das Kommando hat folgende Syntax EXEC CICS ALLOCATE SYSID name C PROFILE name J C NOQUEUE J SYSID name Bezeichnet den Namen f r die ferne UTM Anwendung wie er in einer Connection Definition festgelegt wurde PROFILE name Bezeichnet ein bestimmtes Profil f r die Kommunikation mit dem Partner Profile werden mittels CICS Definitionen festgelegt Anstelle von SYSID und PROFILE kann auch der Parameter PARTNER angegeben werden Dieser Partner muss dann per CICS Definition eingerichtet sein
152. M WAIT J CONVID name Bezeichnet die durch ALLOCATE reservierte Session FROM data area und LENGTH data value Bezeichnen die Adresse und die Lange der Nachricht INVITE Veranlasst dass mit dem Senden der Nachricht das Senderecht change direction an den Partner Ubertragen wird Das Eintreffen des Senderechts wird von openUTM als das Ende der Dialog Nachricht des Partners interpretiert Das UTM Anwendungsprogramm kann dies erkennen wenn es beim nachsten MGET den Returncode 10Z erhalt LAST Veranlasst dass nach dem Senden der Nachricht der Vorgang beendet wird Das UTM Anwendungsprogramm erkennt dies an der Anzeige KCVGST C CONFIRM Veranlasst dass nach dem Senden der Nachricht eine Verarbeitungsquittung vom UTM Anwendungsprogramm gefordert wird Das UTM Anwendungsprogramm er kennt dies an der Anzeige KCRMGT H Der Parameter darf nur bei Sync Level 1 oder 2 angegeben werden WAIT Veranlasst dass das CICS Kommandb erst zur ckkehrt wenn CICS die Nachricht tats chlich abgesendet hat Folgt ein SYNCPOINT Kommando auf das SEND Kommando so sollten Sie diesen Parameter nicht verwenden U5461 J Z135 6 111 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 RECEIVE Dieses Kommando wird verwendet um eine von einem UTM Vorgang gesendete Nachricht zu empfangen Das Kommando hat folgende Syntax EXEC CICS RECEIVE CONVID name INTO data area LENGTH data value C MAXLENGTH data value J C NOTR
153. M Anwendungsprogramm ohne Transaktionssicherung INIT APRO AM KCPI gt A KCOF B FPUT NE KCRN gt A PEND FI FMH5 Daten gt CMACCP CMRCV gt CM_DATA CMRCV gt CM_CONFIRM_DEALLOC_ RECEIVED CMCFMD lt Daten CEB F r diese Art der Kommunikation muss eine openUTM LU62 Instanz verwendet werden die mit dem Parameter UTM ASYNC YES generiert ist Der in Beispiel 20 aufgef hrte Fall ist vom Ablauf her hnlich Der wesentliche Unterschied besteht darin dass das CPI C Programm in Beispiel 20 noch Daten zur cksenden kann Auf UTM Seite hat der Dialog Fall den Vorteil dass die Anwendung ber Erfolg oder Mis serfolg des Aufrufs informiert wird Sendet das CPI C Programm eine negative Verarbeitungsquittung mittels CMSERR so l scht openUTM den Auftrag Das UTM Anwendungsprogramm kann jedoch selbstver st ndlich nicht mehr benachrichtigt werden U5461 J Z135 6 175 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 24 Start eines CPI C Asynchron Vorgangs aus einem UTM Anwendungsprogramm mit Transaktionssicherung INIT APRO AM KCPI gt A KCOF C FPUT NE KCRN gt A PEND FI FMH5 Daten Prepare gt CMACCP CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT lt RequestCommit Committed gt lt Forget RR_OK RETURN Setzt das CPI C Programm die Transaktion zur ck mittels SRRBACK so l scht openUTM
154. M Vorgangs aus einem CICS Anwendungsprogramm gt RECEIVE Client ALLOCATE BUILD ATTACH SEND INVITE SESSIONC RECEIVE SESSION FMH5 Daten gt INIT MGET MPUT NE PEND FI lt FMH5 Daten SRQ R ckkehr des RECEIVE SEND Client RETURN snis SRSP gt 2 Start eines CICS Vorgangs aus einem UTM Anwendungsprogramm Soa INIT MGET Client APRO DM KCPI gt A MPUT NE KCRN gt A PEND KP FMH5 Daten gt RECEIVE SEND LAST RETURN lt Daten SRQ INIT MGET NT KCRN gt A MPUT NE Client PEND FI SFr SRSP gt SRQ Syncpoint Request SRSP Syncpoint Response U5461 J Z135 6 231 CICS Kommandos f r Asynchron Auftr ge openUTM CICS Kopplung ber LU6 1 6 9 CICS Kommandos f r Asynchron Auftr ge Das Senden und Empfangen von Asynchron Auftr gen erfolgt bei CICS mit den Komman dos START und RETRIEVE START Mit diesem Kommando wird ein Asynchron Auftrag erstellt Das Kommando hat folgende Syntax EXEC CICS START LSYSID name TRANSID name FROM bereich LENGTH bereich NOCHECK PROTECT Dabei haben die Parameter folgende Bedeutungen SYSID name spezifiziert den Namen der UTM Anwendung TRANSID name spezifiziert den Transaktionscode f r das Asynchron Progamm bei open UTM Der Name darf bei CICS nicht l nger als 4 Zeichen sein Es kann aber auch ein lokaler TAC Name f r eine remote transaction bei CICS sein siehe Sei
155. MH Die Belegung und Auswertung der Daten im FMH6 wird von IMS teilweise automatisch oder mit der Komponente Message Format Service MFS erf llt Bei openUTM gibt es spezielle Funktionsaufrufe f r UTM Anwendungsprogramme mit denen das Senden einer Nachricht an das in RDPN RPRN angegebene Ziel in der Auftrag geber Anwendung sowie die Belegung von RDPN und RPRN bei Ausgabe Nachrichten m glich ist 250 U5461 J Z135 6 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen Programmschnittstelle f r openUTM 8 1 Programmschnittstelle f r openUTM Mit dem Funktionsaufruf INFO GN get names erh lt ein von einer fernen Anwendung gestarteter Asynchron Vorgang die Werte von RDPN RPRN aus dem Eingabe FMH Mit dem Funktionsaufruf APRO IN insert names wird ein Asynchron Vorgang in einer fernen Anwendung adressiert wobei die Felder DPN PRN RDPN und RPRN f r den Ausgabe FMH explizit belegt werden k nnen Der APRO IN ersetzt in diesem Fall den APRO AM F r die Aufrufe muss neben dem KDCS Parameterbereich ein Datenbereich angegeben werden Der Datenbereich hat folgende Struktur Feldname Bedeutung KCDPN Destination Process Name KCPRN Primary Resource Name Ziel in der fernen Anwendung KCRDPN Return Destination Process Name KCRPRN Return Primary Resource Name Ziel in der lokalen Anwendung Die Felder sind je 8 Bytes lang Beim Aufruf APRO IN muss der Datenbereich vom UTM Anwendungsprogr
156. Meldungen des Programms u62_tp werden auf UNIX Systemen in die Datei opt 1ib utml u62 PROT prot luname auf Windows Systemen in die Datei Programme utmlu62 PROT prot uname txt ausgegeben Die Dienstprogramme u62_gen u62_adm und u62_sta geben ihre Meldungen nach stderr aus Auf Windows Systemen werden zus tzliche Meldungen in die Dateien Programme utmlu62 PROT stdout txt Programme utm1u62 PROT stderr txt ausgegeben sofern openUTM LU62 als Service bei jedem Systemstart gestartet wird Alle Meldungen k nnen in deutscher oder englischer Sprache ausgegeben werden Die Steuerung erfolgt in UNIX Systemen Uber die Umgebungsvariable LANG Beginnt der Wert von LANG mit den Buchstaben De so werden die Meldungen in deutscher Sprache aus gegeben In allen anderen F llen werden englische Meldungen erzeugt Auf Windows Sy stemen werden deutsche Meldungen ausgegeben wenn die L ndereinstellungen im Sy stem auf deutsch gestellt sind ansonsten englische Meldungen In diesem Handbuch werden die Meldungstexte in deutscher Sprache angegeben Namen in Gro buchstaben die mit einem amp beginnen z B amp FILENAME dienen als Platzhalter f r variable Elemente in Meldungstexten U5461 J Z135 6 263 Meldungen des Programms u62_tp Meldungen von openUTM LU62 10 1 Meldungen des Programms u62_tp Im folgenden Abschnitt sind alle Meldungen des Programms u62_tp beschrieben Die Meldungen des Programms u62_tp werden auf U
157. Message Format Service Multiprotocol Transport Networking Multiple Virtual Storage System Network Control Program Open Systems Interconnection Open Systems Interconnection Distributed Transaction Processing Open Systems Interconnection Services Portable Communication Manager in UNIX Padded Data Indicator Programmsystem f r Datenfernverarbeitung und Netzsteuerung Preliminary End of Transaction Process Identifier Program Initialization Parameter Primary Logical Unit Primary Resource Name Queued Response Indicator Resource Access Control Facility Resource Definition Online 374 U5461 J Z135 6 Abk rzungen RDPN RPRN RLU RTI RTR RU SDI SDLC SSCP SIT SLU SNA SNI TNSX TP TPSU TX UDT UTM VLVB VM VTAM XAP XAP TP XLN Return Destination Process Name Return Primary Resource Name Remote Logical Unit Response Type Indicator Ready to Receive Request Unit Sense Data Indicator Synchronous Data Link Control System Services Control Point System Initialization Table Secondary Logical Unit System Network Architecture SNA Network Interconnection Transport Name Service UNIX Transaction Processing Transaction Program Transaction Processing Service User Transaction Demarcation X Open Unstructered Data Transfer Universeller Transaktionsmonitor Variable Length Variable Blocked Virtual Machine Virtual Telecommuncations Access Method X Open ACSE Presentation Services X Open ACSE Presen
158. NAME Die Kommunikation zum LU6 2 und zum OSI TP Partner wird erst nach Richtig stellung der Konfigurierung der LU6 2 Basis Software gestartet Ist die in der Generierung von openUTM LUB2 enthaltene lokale LU amp LLUNAME Konfigurationsparameter LOC LU ALIAS oder die ferne LU amp RLUNAME Konfigu rationsparameter REM LU ALIAS nicht in der LU6 2 Basis Software konfiguriert so wartet openUTM LU62 mit dem Start der Kommunikation mit dem OSI TP und dem LU6 2 Partner Im Falle von TRANSIT als LU6 2 Basis Software kann die Ur sache auch das Fehlen eines geeigneten PAIR Parameters sein das den Zusam menhang zwischen der lokalen und der fernen LU herstellt Wird TRANSIT been det umkonfiguriert und wieder gestartet so sollte alles wieder laufen Fehler in der Konfiguration der lokalen LU amp LLUNAME und der Partner LU amp RLUNAME ist nun korrigiert Die Kommunikation zum LU6 2 und zum OSI TP Partner wird jetzt gestartet openUTM LU62 hat beim Start eine Inkonsistenz zur Generierung der LU6 2 Ba sis Software z B von TRANSIT festgestellt und die Meldung 040 ausgegeben Nachdem nun die Konfiguration der LU6 2 Basis Software korrigiert worden ist gibt openUTM LU62 die Meldung 041 aus und startet die Kommunikation mit seinen beiden Partnern durch Absetzen eines RECEIVE_ALLOCATE Aufrufs auf LU6 2 Seite und durch ffnen der XAP TP Dialog Instanzen auf OSI TP Seite Der Netzname der Partner LU amp ALIASNAME ist umkonfiguriert worden vo
159. NG_DUMP_APPL XFSA07 MX Modul KCOXFHF Funktion SetAttribute Beim Setzen des Attributs AP_DTNID lieferte die Funktion PutElement einen Returncode ungleich DM_OK U5461 J Z135 6 273 Meldungen des Programms u62_tp Meldungen von openUTM LU62 028 030 031 032 Abbruch durch internen Watch Dog Das Programm u62_tp berwacht st ndig dass jeder Funktionsaufruf nicht l nger als eine fest vorgegebene Zeitspanne dauert Auf diese Weise werden Endlos schleifen und blockierende Systemfunktionen automatisch erkannt Dieser Fehler kann gelegentlich beim Beenden von TRANSIT auftreten Tritt er sonst auf handelt es sich um einen Systemfehler Kaltstart von openUTM LU62 da die Synclog Datei amp SYNCLOG fehlt openUTM LU62 wurde ohne den Schalter c aufgerufen soll also einen Warmstart durchf hren Wenn jedoch open UTM LU62 noch nie erfolgreich f r die angegebe ne lokale LU gestartet wurde fehlt die Datei amp SYNCLOG mit den Informationen f r einen Warmstart In diesem Fall zeigt die Meldung 030 an dass stattdessen ein Kaltstart durchgef hrt wird Diese Meldung dient lediglich der Information des Sy stemverwalters Fehler beim Oeffnen der Synclog Datei amp SYNCLOG errno amp ERRNO amp ERRTEXT Da die CCR Syntax fehlt wird die Initialisierung jedoch fortgesetzt Diese Meldung wird w hrend der Initialisierung ausgegeben wenn openUTM LU62 ohne den Schalter c gestartet wurde der
160. NIX Systemen in die Datei opt 1ib utm1lu62 PROT prot luname auf Windows Systemen in die Datei Programme utm1lu62 PROT prot uname txt ausgegeben wobei uname der jeweilige Name der LU ist Alle Meldungen beginnen mit der Zeichenfolge u62_tp komp nnn Hiebei bezeichnet komp die Komponente des Programms u62_tp und nnn die Meldungs nummer Es gibt folgende Komponenten BD Boundary Behandlung der Schnittstellen APPC und XAP TP sowie der Schnitt stelle zum System DM Dialogue Manager Behandlung der OSI TP Dialoge und LU6 2 Conversations RS Resync Service Transaction Program Wiederaufsetzen in der Startphase und nach Leitungsausfall TM Transaction Manager Behandlung der Transaktionssicherung In der Datei prot luname stehen au erdem noch Meldungen von u62_start Diese sind mit dem Vorspann u62_start versehen und ab Seite 343 beschrieben Meldungen der Komponente BD 002 Aufruf u62_tp I lt LU Name gt cl k t on lt Trace Optionen gt I LU Name Name der lokalen LU der openUTM LU62 Instanz C Kaltstart von openUTM LU62 k Lauwarmer Start von openUTM LU62 ton Explizite Spezifikation des Trace durch Angabe von Optionen moeglich durch Komma getrennt IN lt Level gt mit Instanz Trace XAP mit XAP TP Provider Trace Das Programm u62_tp wird intern von u62_start aufgerufen Bei fehlerhafter Para meterversorgung durch u62_start erscheint diese Meldung 264 U5461 J Z135 6 Meldu
161. NOQUEUE Bedeutet dass nicht gewartet werden soll falls nicht sofort eine Session verf gbar ist CICS gibt nach erfolgreichem ALLOCATE Kommando im Feld EIBRSRCE eine CONVID zur ck Diese CONVID muss in allen nachfolgenden Aufrufen angegeben werden die sich auf die hier belegte Session beziehen U5461 J Z135 6 109 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 CONNECT PROCESS Mit diesem Kommando beginnt die LU6 2 Conversation Das Kommando hat folgende Syntax EXEC CICS CONNECT PROCESS CONVID name PROCNAME data area PROCLENGTH data value SYNCLEVEL data value CONVID name Bezeichnet die durch ALLOCATE reservierte Session PROCNAME data area und PROCLENGTH data value Bezeichnen den UTM Transaktionscode SYNCLEVEL data value Bezeichnet das Synchronisations Level des LU6 2 Protokolls Der Parameter ent spricht dem Feld KCOF beim UTM Aufruf APRO 0 entspricht KCOF B Basisfunktionen 1 entspricht KCOF H Handshake Funktionen 2 entspricht KCOF C Commit Funktionen Die Verwendung der Parameter PIPLIST und PIPLENGTH zum Senden von PIP Daten program initialization parameter ist nicht m glich 110 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren SEND Dieses Kommando sendet eine Dialogteilnachricht Das Kommando hat folgende Syntax EXEC CICS SEND CONVID name FROM data area LENGTH data value C INVITE LAST J CE CONFIR
162. NSIT auf Solaris Kopplung mit IBM Systemen 2 10 LU6 1 Kopplung ber Gateway Rechner mit TRANSIT auf Solaris Die folgende Kopplungsm glichkeit ber LU6 1 kann immer dann eingesetzt werden wenn der Rechner auf dem die UTM Anwendung l uft nicht direkt an das SNA Netz angebun den werden soll oder kann Das Betriebssystem dieses Rechners ist beliebig Es kann z B BS2000 OSD ein Solaris oder Linux System ein Windows System oder ein anderes UNIX System sein Als Gateway Rechner wird ein Solaris System ben tigt UNIX System BS2000 0SD oder Windows System IBM Rechner openUTM CICS oder IMS CMX PCMX bzw BCAM SNA Basis Software z B VTAM Solaris Rechner CMX TRANSIT CLIENT mit UTMGW1 TRANSIT SERVER SNA ber Ethernet LU6 1 Kopplung ber Gateway Rechner mit TRANSIT auf Solaris Die Verbindung zwischen den beiden linken Rechnern erfolgt ber TCP IP mit RFC1006 Im Bild ist eine SNA Kopplung ber Ethernet dargestellt Zu anderen Kopplungsm glichkei ten siehe das Handbuch TRANSIT SERVER 34 U5461 J Z135 6 3 LU6 2 Kopplungen mit openUTM LU62 Das Produkt openUTM LU62 erm glicht die Kommunikation zwischen UTM Anwendungen und LU6 2 Anwendungen d h Anwendungen die das Protokoll LU6 2 verwenden Bei spiele f r solche LU6 2 Anwendungen im IBM Umfeld sind CICS IMS ab der Version 5 TXSeries und CPI C Anwendungen ber das Protokoll LU6 2
163. NVITE WAIT CONVID m gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST 0 MPUT NE PEND KP ur ee NORMAL RECEIVE CONVID RETURN ee gt INIT PU ENDTA R SEND N MGET KCRLM 0 VGST 0 TAST P PEND RE ta rated Ite Fortsetzung n chste Seite 148 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren Fortsetzung CICS Client CICS 6000 CICS ESA openUTM INIT PU ENDTA F SEND N MGET KCRLM 0 VGST 0 TAST P PEND FI ECI_NO_ERROR U5461 J Z135 6 149 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 2 7 Hinweise zur openUTM Programmierung Folgende Punkte sind bei der Programmierung von UTM Anwendungen zu ber cksichti gen wenn diese Anwendungen mit LU6 2 Partnern kommunizieren wollen 1 Fordert ein UTM Anwendungsprogramm als Auftraggeber den LU6 2 Partner mittels CTRL PR oder CTRL PE auf das Transaktionsende einzuleiten so kann es danach keine Daten mehr vom Partner empfangen und zwar unabh ngig davon ob es vor dem CTRL einen MPUT aufgerufen hat oder nicht Diese Einschr nkung erfordert in vielen F llen einen zus tzlichen Dialogschritt Benutzerdaten k nnen nur im UDT Format transportiert werden Dies bedeutet dass bei MPUT FPUT DPUT an einen LU6 2 Partner das Feld KCMF immer mit Leerzei chen versorgt sein muss Benutzerdaten k nnen bei Verwendung von TRANSIT nur bis zu einer L nge von 32763 Byte von UTM an CICS g
164. P IJWOSICL TYPE D TLE 1 2 29664 Die wesentlichen Parameter in diesem Beispiel sind Parameter IMS Host openUTM LU62 openUTM Windows Endsystem IP Adresse 111 22 33 244 111 22 33 233 111 33 55 111 F45519AC LU Name P390 IMSA P390 IMSJ LU Alias Name PA713236 IUWIMSJ CP Name P390 P390SSCP P390 MHPBO2GC IDBLK IDNUM 05D 25129 MODE Name APPCHOST T Selektor IUWOSICL SMP23000 Port Nummer 29664 23000 AP Title 1 2 29664 1 2 29660 AE Qualifier 712614 1 APPL Context UDTSEC U5461 J Z135 6 193 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 5 2 openUTM IMS Kopplung programmieren 5 2 1 IMS Anwendungsprogramme die LU6 2 nutzen k nnen mit den beiden Programmschnitt stellen DL I oder CPI C realisiert sein In der IMS Literatur unterscheidet man zwischen 3 Varianten von IMS Anwendungspro grammen bei LU6 2 Kommunikation e Standard DL I Anwendungsprogramm verwendet nur DL I Aufrufe e Modified DL l Zum Lesen der Nachricht vom Auftraggeber und zum Senden der Ant wort an den Auftraggeber wird DL I verwendet Zus tzlich wird CPI C verwendet um eine Kommunikation zu einem Auftragnehmer aufzubauen e CPI C Anwendungsprogramm verwendet ausschlie lich CPI C Aufrufe Programmschnittstelle DL I DL I ist die herk mmliche IMS Programmschnittstelle Bestehende DL I Programme die Nachrichten von Kommunikationspartnern en
165. P22800 ye ye L RFC1006 T SMP22804 TSEL LANINET A 22804 BCAM Generierung BCIN LCOQ090 IPADR 123 45 67 90 BCMAP FU DEF SUBFU GLOBAL ES LCO090 NAME SMP22804 PPORT 22804 PTSEL I SMP22804 openUTM Generierung ACCESS POINT OSIREP8 NONE P SE S SE T SE AEQ OSI CON P SE S SE T SE N SE LOCA OSI S M 1 ur Il S c SC NONE MP22800 22804 NONE NONE SMP22804 LC0090 ACCESS POINT OSIREP8 LPAP ACICSO4 24 3 32 33 29 30 2 34 35 36 37 38 39 36 37 40 31 32 C29 26 34 35 36 38 40 41 Der Rest der openUTM Generierung ist unver ndert Ebenso sind alle anderen Teile der Beispielgenerierung unver ndert 92 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren nderungen bei Verwendung von openUTM LU62 f r Windows Systeme Bei Verwendung von openUTM LU62 auf Windows Systemen ndert sich lediglich die TRANSIT Generierung Da in diesem Fall anstelle von TRANSIT das Produkt IBM Commu nications Server for Windows verwendet wird m ssen die Generierungsparameter in der Syntax dieses Produktes definiert werden Normalerweise werden die Generierungspara meter ber Men s eingetragen Hieraus kann der Anwender eine Generierungsdatei acg erzeugen und dabei Namen und Ablageort w hlen
166. PEND FI Committed gt lt Forget NORMAL RETURN hnlich wie in den Beispielen 12 und 13 k nnen einige UTM Aufrufe entfallen wenn man im Teilprogramm auf die Rollback Commit Information von CICS verzichtet Der 2 und 3 Programmabschnitt reduziert sich dann auf die Folge INIT MGET NT KCRN gt A VGST 0 TAST 0 CTRL PR KCRN gt A MPUT NE Client PEND RE Diese Variante unterscheidet sich von der vorhergehenden dadurch dass die Antwortnach richt des CICS Anwendungsprogramms noch innerhalb der ersten Transaktion gesendet wird Bei der ersten Variante wird die Antwortnachricht in der zweiten Transaktion gesendet Die zweite Variante ist aufwandiger zu programmieren und erzeugt auch mehr Nachrichten als die erste Variante Sie hat aber den Vorteil dass eine eventuell mit dem PEND RE gekoppelte Datenbank nderung erst nach Erhalt der Nachricht vom CICS Anwendungs programm festgeschrieben wird 138 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 17 CICS Anwendungsprogramm setzt Transaktion zur ck und bricht Vorgang ab erste Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PEND KP FMH5 Daten gt RECEIVE STATE SEND SYNCPOINT ROLLBACK ISSUE ABEND RETURN lt FMH7 FMH7 Response gt R cksetzen der Transaktion evtl mit Meldung K034 auf Client Falls zuvor schon ein Sicherungspunkt erreicht
167. Partner gibt als Grund release urgent an 23 RELEASE_USER_DEFINED Die Association wird vom Partner mit release abgebaut Der Partner gibt als Grund user defined an 24 IDLE_TIMEOUT_ABORT Die Association wird von der lokalen Anwendung abgebaut weil die Association in der mit IDLETIME generierten Zeit nicht benutzt worden ist 342 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen von u62_start 10 3 Meldungen der Dienstprogramme 10 3 1 Meldungen von u62_start Alle Meldungen von u62_start mit Ausnahme der Meldung 18 werden nach stdout aus gegeben Die Meldungen 17 und 18 werden auf UNIX Systemen in die Datei opt 1ib utml u62 PROT prot luname auf Windows Systemen in die Datei Programme utmlu62 PROT prot uname txt geschrieben 02 03 04 05 06 Aufruf u62_ start lt LU Name gt c k t on lt Trace Optionen gt I LU Name Name der lokalen LU der openUTM LU62 Instanz C Kaltstart von openUTM LU62 k Lauwarmer Start von openUTM LU62 ton Explizite Spezifikation des Trace durch Angabe von Optionen moeglich durch Komma getrennt IN lt Level gt mit Instanz Trace XAP mit XAP TP Provider Trace u62_start wurde mit falschen Schaltern oder Parametern aufgerufen openUTM LU62 wird nicht gestartet Wechsel ins Basis Directory amp DIRNAME nicht moeglich errno amp ERRNO amp ERRTEXT Das Directory amp DIRNAME laesst sich nicht anlegen errno amp E
168. REM AE bzw einer der Parameter REM NSEL REM TSEL REM LISTENER PORT Pflichtparameter CONTWIN fehlt TNS Eintraege und Parameter fuer den TNS losen Betrieb duerfen nicht gleichzeitig vorkommen Ungueltige Port Nummer Es duerfen nur die Ports 102 und 1025 65535 verwendet werden Aufruf Generierung u62_gen f lt Ausgabedatei gt lt Eingabedatei gt Reverse u62_gen r lt Konfigurationsdatei gt Datei amp FILENAME kann nicht geoeffnet werden errno amp ERRNO amp ERRTXT 356 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen von u62_gen 52 53 54 55 56 57 58 59 60 62 Die Version von u62_gen stimmt nicht mit der Datei amp FILENAME ueberein amp VERS1 statt amp VERS2 oder die angegebene Datei wurde nicht mit u62_gen erzeugt Diese Meldung tritt nur bei Verwendung des Schalters r auf u62_gen hat festge stellt dass die bin re Konfigurationsdatei amp FILENAME die falsche Versionsken nung amp VERS enth lt Diese m sste mit der Version amp VERS2 von u62_gen berein stimmen Vermutlich wurde lediglich eine neue Version von openUTM LU62 instal liert und anschlie end mit u62_gen r versucht die vorliegende bin re Konfigurationsdatei in ein lesbares Format zu wandeln INSTANCE Anweisung fehlt Application Context amp CONTEXT nicht definiert Fehler in Zeile amp LINENO Der angegebene Application Context amp CONTEXT stimmt mit keinem der zul ssigen Werte UDTSEC UD
169. RQ gt lt Daten SRQ GU 10 PCB RETURN SRQ Syncpoint Request SRSP Syncpoint Response U5461 J Z135 6 247 IMS Programmierung bei Kopplung mit openUTM openUTM IMS Kopplung ber LU6 1 7 4 6 Hinweise zur openUTM IMS Programmierung Wenn IMS Auftraggeber ist wird der Name der aufzurufenden UTM Transaktion normaler weise mit den Daten gesendet Der UTM Anwender muss das im Eingabebereich ber ck sichtigen hnlich wie bei einer Kopplung mit CICS muss auch bei einer Kopplung mit IMS das Pro blem der Datenkonvertierung beachtet werden Siehe hierzu Seite 234 Weitere Hinweise zum Austausch von Asynchron Auftr gen sind ab Seite 249 beschrie ben Vereinbarungen bei der openUTM IMS Programmierung Zwischen den Partnern openUTM und IMS m ssen f r die Programmierung folgende Punkte vereinbart werden Namen der Transaktionen Art der bergabe des Transaktionscodes Datenformat VLVB oder Chain of RUs synchron asynchron Werte im FMH6 asynchron 248 U5461 J Z135 6 8 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen Die Programmierung einer LU6 1 Kopplung zwischen openUTM und IMS ist oft schwierig da von IMS aus keine synchronen Auftr ge in einer UTM Anwendung gestartet werden k nnen Das LU6 1 Protokoll bietet aus diesem Grund die M glichkeit Pseudo Dialoge zwischen Asynchron Vorg ngen zu bilden Mittels spezieller Erweiterungen der KDCS die in den normalen UTM Handb cher
170. RRNO amp ERRTEXT Instanz amp INST Fehler beim Abholen der Quittung vom Gateway Anzahl gelesener Bytes fehlerhaft Die Systemfunktion recv zum Abholen der Quittung von der Instanz amp INST hat nicht das erwartete Ergebnis gebracht was zum Abbruch des Programms f hrt Wird als Instanz ausgegeben so stehen noch mindestens zwei Quittungen von unterschiedlichen Instanzen aus 350 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen von u62_adm 10 3 3 Meldungen von u62_adm Die Meldungen 03 bis 13 sowie die Meldungen 16 und 17 haben jeweils die gleiche Bedeu tung wie die entsprechende Meldung des Programms u62_sta Diese Meldungen deuten auf einen Fehler in der Kommunikation zwischen dem Administrationsprogramm u62_sta oder u62_adm und dem Programm u62_tp hin 02 14 15 20 21 22 Aufruf u62_adm I lt LU Name gt ton lt Trace Optionen u62_adm lt LU Name gt tof lt Trace Optionen gt u62_adm I lt LU Name gt tfl lt Trace Optionen gt u62_adm lt LU Name gt co u62_adm I lt LU Name gt cs u62_adm lt LU Name gt do u62_adm lt LU Name gt ds u62_adm lt LU Name gt ao u62_adm lt LU Name gt as u62_adm lt LU Name gt e u62_adm lt LU Name gt v u62_adm f p o lt Ausgabe gt lt Trace 1 gt lt Trace 2 gt Instanz amp INST Konfiguration der LU6 2 Software und openUTM LU62 inkonsistent Diese Fehlermeldu
171. RRNO amp ERRTEXT Sind bei Aufruf von u62_start die Unterverzeichnisse PROT und auf UNIX Syste men pipes von opt 1ib utmlu62 bzw Programme utm1u62 nicht vorhanden z B beim ersten Start nach der Installation von openUTM LU62 so legt u62_start diese vor dem Aufruf von u62_tp an Geht der entsprechende System aufruf mkdir schief so gibt diese Meldung genauere Auskunft ber die Fehlerur sache amp ERRNO Inhalt der Systemvariablen errno amp ERRTXT Kurzerkl rung zu amp ERRNO Das Directory amp DIRNAME kann nicht gelesen werden errno amp ERRNO amp ERRTEXT Die Konfigurationsdatei amp FILENAME kann nicht geoeffnet werden errno amp ERRNO amp ERRTEXT U5461 J Z135 6 343 Meldungen von u62_start Meldungen von openUTM LU62 07 08 09 10 11 12 13 14 15 16 Fehler beim Einlesen der Konfigurationsdatei amp FILENAME errno amp ERRNO amp ERRTEXT Die Version von u62_start stimmt nicht mit der Konfigurationsdatei amp FILENAME ueberein amp VERS1 statt amp VERS2 Die von u62_gen erzeugte Konfigurationsdatei amp FILENAME enth lt eine falsche Versionsnummer Entweder handelt es sich bei amp FILENAME um gar keine Konfigu rationsdatei oder es wurde eine inkompatible Version von u62_gen zur Generierung verwendet Der lokale LU Name amp LUNAME ist nicht konfiguriert Die Instanz fuer den lokalen LU Namen amp LUNAME laeuft bereits Nicht genug Speicherplatz vorhanden Interner Fe
172. RTNER_LU ADJAC PARAL PARTN PREFE SPLIT_STACK ONWINNERS_SOURCE 6 ODE_SESSION_LIMIT 12 VE_PACING_WINDOW 1 FQ_PLU_NAME P390 IMSA ENT_CP_NAME CONV_SECURITY_VERIFICATION 1 MAX_MC_LL_SEND_SIZE 32767 LEL_SESSION_SUPPORT 1 ER_LU_ALIAS PA713236 RENCE USE_DEFAULT_PREFERENCE STARTUP 1 POOL_ SHARED_FOLDERS AME CACHE_SIZE 256 EXTENSION_LIST LOAD_BALANCING ADVERTISE_FREQUENCY 1 APPC_LU_LOAD_FACTOR 0 DEFAULT_MAX_LU62_SESSIONS 512 ENABLE_LOAD_BALANCING 0 HOST_LU_LOAD_FACTOR 0 LOAD_VARIANCE 3 VERIFY CFG_MODIFICATION_LEVEL 12 CFG_VERSION_LEVEL 1 CFG_LAST_SCENARIO 6 190 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren openUTM LU62 Generierung ohne Verwendung von TNSX INSTANCE LOC LU ALTAS IJWIMSJ LOC TSEL T IJWOSICL LOC LISTENER PORT 29664 LOC APT 1 2 29664 LOC AEQ 712614 LLOC TIME 0 U62 CODE NO EM AEQ 1 ASSOCIATIONS 12 CONNECT 12 CONTWIN 6 OSITP CODE NO EM LU ALTAS PA713236 ODENAME APPCHOST R M A L REM NSEL utmhost REM LISTENER PORT 23000 REM TSEL T SMP23000 REM APT 1 2 29660 R APPL CONTEXT UDTSEC openUTM LU62 Generierung bei Verwendung von TNSX INSTANCE LOC LU ALIAS IJWIMSJ LOC AE IJWOSICL LOC APT 1 2 29664 LOC AEQ 712614 R M ALLOC TIME 0 LU62 CODE NO R R R EM AE EM AEQ 1 ASSOCIATION
173. S 12 CONNECT 12 CONTWIN 6 OSITP CODE NO EM LU ALTAS PA713236 ODENAME APPCHOST BCOSIO SMP23000 EM APT 1 2 29660 APPL CONTEXT UDTSEC U5461 J Z135 6 191 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 TNSX Generierung BCOSIO SMP23000 TA RFC1006 111 33 55 111 PORT 23000 T SMP23000 PSEL yrs SSEL yee IJWOSICL TSEL RFC1006 T IJWOSICL TSEL LANINET A 29664 PSEL Vz SSEL vi UTM Generierung UTMD APT 1 2 29660 MAXJR 200 CONCTIME 180 60 PTCT IME 0 ACCESS POINT BCOSIO P SEL NONE S SEL NONE T SEL C SMP23000 T PROT RFC1006 z LISTENER PORT 23000 TSEL FORMAT T OSI CON IJWOSICL ACTIVE YES ER PORT 29664 LOCAL ACCESS POINT BCOSIO MAP USER L C MHPBO2GC LPAP IJWOSICL L NONE L NONE OT RFC1006 L C IJWOSICL TSEL FORMAT T Do m AO m m I m 192 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren OSI LPAP IJ APPLICAT ASSOCIAT ASSOCIAT OSICL APPLICAT APPLICAT TON CONTEXT UD SEC TON ENTITY QUALIFIER 712614 TON PROCESS TI ION NAMES IJW IONS 12 CONNECT 12 CONTWIN 6 IDLETIME 0 PERMIT ADMIN STATUS ON TAC DATAECHO PROGRA TYPE D LTAC LIMSO RTAC I LPAP IJ TYPE D LTAC LIMS1 RTAC 1 comims SO WOSICL Sl LPAP IJ TYPE A LTAC ICPC WOSICL RTAC CSVRCPIC LPA
174. SEG RESPONSE LTAC IMSASY1S TRANSACT RTAC ASYNC1 CODE ASYNC1 TYPE A MSGTY PE MULTSEG NONRESPONSE gee a E E E ae le ke U5461 J Z135 6 243 IMS Programmierung bei Kopplung mit openUTM openUTM IMS Kopplung ber LU6 1 7 4 IMS Programmierung bei Kopplung mit openUTM Im Folgenden soll ein grober berblick einer openUTM IMS Kommunikation vermittelt werden 7 4 1 Kopplungsm glichkeiten mit IMS Synchrone Auftr ge Dialog IMS erlaubt auf Grund seiner Struktur message queues keine synchronen Transaktionen wenn IMS Auftraggeber front end ist d h wenn eine Anfrage vom Terminal von IMS an openUTM geht und eine synchrone Antwort von openUTM erwartet wird Wenn IMS der Auftragnehmer back end ist kann ein Dialog zwischen openUTM und IMS aufgebaut werden Ob die IMS Transaktion synchron oder asynchron abl uft wird im IMS festgelegt durch den Parameter MSGTYPE im TRANSACT Makro RESPONSE oder NONRESPONSE Au er dieser internen Spezifikation kann die Art des Ablaufes auch ber die Form der ankommenden Meldung bestimmt werden Wird von openUTM ein Dialogverkehr gestartet MPUT so antwortet IMS synchron auch wenn im TRANSACT Makro NONRESPONSE angegeben wurde Asynchron Auftr ge Bei Kopplungen mit IMS wird auf Grund der Einschr nkung des Dialogs oft der asynchrone Datenverkehr verwendet Die Synchronisierung der Antworten auf entsprechende Anfra gen wird dem Benutzer berlassen Es gibt aber M glichkeit
175. Senden einer Nachricht vgl Flush bei CPI C SETO 1 O PCB oder Alt PCB I O set options Senden von Send_Error oder Area opt list Deallocate_Abend Zus tzlich k nnen im LU6 2 Umfeld folgende DL I Aufrufe f r System Services genutzt werden Name Parameter Bedeutung Verwendung INQY aib VO Area inquiry Abfragen von Eigenschaften des Output PCB ROLB 1 O PCB I O rollback Senden von Deallocate_Abend und Rollback der Transak Area tion normale Fortsetzung des Anwendungsprogramms ROLL keiner roll Senden von Deallocate_Abend und Rollback der Transak tion abnormales Programmende L schen der Eingabe Nachricht ROLS 1 O PCB I O rollback to Senden von Deallocate_Abend und Rollback der Transak Area token sets setu tion Programmende Eingabe Nachricht bleibt in Queue erhalten R cksetzpunkt kann spezifiziert werden SETS _ I O PCB I O set backout Setzen eines R cksetzpunktes f r einen nachfolgenden Area token point ROLS SETU I O PCB I O set Wie SETS jedoch mit etwas anderem Verhalten in Fehler Area token unconditional situationen SYNC _ I O PCB sycnpoint Setzen eines Sicherungspunktes Bedeutung der Parameter 1 O PCB und Alt PCB Beim Empfangen und Senden einer Nachricht wird ein PCB program communica tion block bergeben in dem Informationen wie Status Partnername LTERM usw abgespeichert werden Wird eine Nachricht an den Auftraggeber zur ckge sen
176. T amp OSLPAP Name des Partners in der lokalen Anwendung amp XPOOBID amp XP9OBID sind die maximal zehn Elemente des Objektbezeichners die den Application Context Namen des fernen Partners bilden F r nicht belegte Elemente wird 7 ausgegeben P007 Fehler beim Assoziationsaufbau a_assrs amp ACPNT amp OSLPAP amp XPRET amp XPERR amp XP1INFO amp XP2INFO Diese Meldung wird ausgegeben wenn der Aufruf der OSS Funktion a_assrs mit der der Associationsaufbau von au en beantwortet wird einen Fehler liefert Han delt es sich um einen vom Transportsystem gemeldeten Fehler wird zus tzlich die Meldung P012 ausgegeben Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPRET siehe Tabelle auf Seite 334 amp XPERR siehe Tabelle auf Seite 334 amp XPIINFO OSS Zusatzinformation amp XP2INFO OSS Zusatzinformation 318 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers P008 P009 P010 Assoziation aufgebaut amp ACPNT amp OSLPAP Diese Meldung wird ausgegeben wenn eine Association aufgebaut wurde Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung Assoziation abgelehnt a_asscf amp ACPNT amp OSLPAP Grund amp XPRJCT Laenge amp XPLTH Diese Meldung wird ausgegeben we
177. T ROLLBACK MPUT RM KCRN lt PEND RS INIT MGET NT KCRN lt Rucksetzen der Transaktion und Abbruch des Vorgangs SYNCPOINT ROLLBACK PEND ER FR ISSUE ABEND Nachrichtenaustausch mit Verarbeitungsquittung SEND INVITE CONFIRM MPUT NE KCRN gt RECEIVE MPUT HM KCRN gt PEND KP INIT MGET NT KCRN gt Senden einer Antwort mit positiver Verarbeitungsquittung ISSUE CONFIRMATION MPUT NE KCRN gt SEND PEND FI Senden einer Antwort mit negativer Verarbeitungsquittung ISSUE ERROR MPUT EM KCRN gt Abbruch des Dialogs zum Partner ISSUE ABEND CTRL AB 122 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 4 2 5 Beispiele f r open UTM CICS Kommunikation Start eines openUTM Dialogvorgangs aus einem CICS Anwendungsprogramm 1 Einschrittvorgang mit Transaktionssicherung gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND INVITE WAIT CONVID FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST 0 MPUT NE PEND KP lt Daten RECEIVE CONVID SEND LAST CONVID SYNCPOINT Daten RequestCommit gt INIT PU ENDTA 0 SEND N MGET VGST 0 TAST P PEND FI lt Committed NORMAL SEND Client J RETURN Im obigen Ablaufbeispiel wurde im UTM Anwendungsprogramm der Aufruf INIT PU ver wendet weil man damit Transaktionsende
178. TAC UDTDISAC UDTCCR berein STOP Fehler u62_gen hat einen schwerwiegenden Fehler festgestellt und daher die Bearbeitung der Eingabedatei abgebrochen Eine Konfigurationsdatei wurde nicht erstellt Nicht genug Speicherplatz vorhanden Interner Fehler aufgetreten Fehler beim Schreiben in die Datei amp FILENAME errno amp ERRNO amp ERRTXT Die h ufigste Ursache d rften falsche Zugriffssrechte auf das Verzeichnis oder die bereits bestehende Konfigurationsdatei oder aber ein volles Dateisystem sein Fehler beim Lesen aus der Datei amp FILENAME errno amp ERRNO amp ERRTXT Generierung in die Datei amp FILENAME u62_gen hat keine Fehler in der Eingabedatei festgestellt und die bin re Konfigura tionsdatei amp FILENAME erzeugt openUTM LU62 kann nun gestartet werden Der aktuelle User ist nicht zur Generierung der Konfiguration berechtigt Benutzer des UNIX Systems ungleich root die nicht in der Konfigurationsdatei u62_users aufgelistet sind d rfen open UTM LU62 nicht um konfigurieren U5461 J Z135 6 357 358 U5461 J Z135 6 Fachw rter Adressierbare SNA Instanz network adressable unit Oberbegriff f r LU PU SSCP Advanced program to program communication APPC Anderer Name f r das LU6 2 Protokoll und die zugrunde liegende Architektur Wird manchmal auch verwendet f r eine Programmschnittstelle zum Zugriff auf das LU6 2 Protokoll APPC application program interface Agent Bei vert
179. TM LU62 Instanz einmal gestartet Das Write Log Programm u62_w1og sorgt f r das Schreiben der Log Records auf Datei Es wird pro openUTM LU62 Instanz als sogenannter Write Log D mon einmal gestar tet wenn Transaktionssicherung verwendet wird Zus tzlich gibt es Dienstprogramme f r Generierung u62_gen und f r Administration u62_adm u62_sta Auf Windows Systemen gibt es zus tzlich das Programm u62_svc Dieses wird verwen det wenn openUTM LU62 automatisch beim Systemstart als Service gestartet werden soll Alle Programme mit Ausnahme von u62_sta liegen auf UNIX Systemen im Dateiverzeich nis opt 1ib utm1u62 und k nnen standardm ig von jedem Benutzer aufgerufen werden Es ist m glich die Rechte zur Administration auf bestimmte Benutzer des UNIX Systems einzugrenzen siehe Abschnitt Administration unter UNIX und Windows Systemen auf Seite 54 Das Programm u62_sta liegt auf UNIX Systemen unter opt bin und kann von jedem Be nutzer aufgerufen werden Auf Windows Systemen liegen die Administrationsprogramme im Dateiverzeichnis Programme utm1u62 wobei Programme utm1u62 das Standard Installationsverzeichnis des openUTM LUB2 ist Die Interprozesskommunikation zwischen u62_tp einerseits und u62_wlog bzw u62_adm bzw u62_sta ist auf UNIX Systemen mittels Named Pipes und Shared Memory realisiert Auf Windows Systemen laufen u62_tp und u62_wlog als Threads im selben Prozess u62_tp exe Die Interprozesskommunikat
180. TP_COMMIT_IND fd 10 10 46 47 line 4407 corr 1 lt U5461 J Z135 6 69 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 Die UTM Anwendung startet nun die zweite Phase des 2 Phase Commit Protokolls openUTM LU62 erh lt zweimal ein TP_COMMIT_IND openUTM h tte die Transaktion zu diesem Zeitpunkt auch noch zur cksetzen k nnen Nach dem TP_COMMIT_IND ist dies jedoch nicht mehr m glich MC_SEND_DATA tpid 00984982 lt 10 46 47 line 4517 corr 1 send_type SEND_DATA_P_TO_R_FLUSH data_type PS_HEADER Committed Aufgrund des erhaltenen TP_COMMIT_IND sendet openUTM LU62 ein Committed an CICS MC_RECEIVE_IMMEDIATE tpid 00984982 gt 10 46 47 line 4596 corr 1 what_rcvd PS_HEADER_COMPLETE Forget MC_RECEIVE_AND_POST tpid 00984982 gt 10 46 47 line 4695 corr 1 primary_rc DEALLOC_NORMAL CICS antwortet mit einem Forget Der anschlieBende DEALLOC_NORMAL zeigt an dass die Conversation nach dem Transaktionsende wie vom UTM Anwendungsprogramm beim CTRL PE gew nscht beendet wurde TP_DONE_REQ fd 0 10 46 47 line 4802 corr 1 gt TP_COMMIT_COMPLETE_IND fd 0 10 46 47 line 4877 corr 1 lt TP_COMMIT_COMPLETE_IND fd 10 10 46 47 line 4949 corr 1 lt openUTM LU62 sendet den erhaltenen Forget als TP_DONE_REQ an die UTM Anwen dung Nach Erhalt des zweiten TP_COMMIT_COMPLETE_IND sind die Transaktion
181. UNCATE J CONVID name Bezeichnet die durch ALLOCATE reservierte Session INTO data area und MAXLENGTH data value Bezeichnet die Adresse und L nge des Puffers zur Aufnahme der Nachricht LENGTH data value Hier gibt CICS die L nge der erhaltenen Nachricht zur ck NOTRUNCATE Der Rest der Nachricht wird nur bertragen wenn er k rzer als MAXLENGTH ist Ist NOTRUNCATE nicht angegeben so wird eine Nachricht bis zur Lange MAXLENGTH zugestellt Der Rest wird verworfen Ist NOTRUNCATE angegeben so k nnen weitere Teile mit RECEIVE angefordert werden CONVERSE Dieses Kommando bewirkt dass eine Nachricht an den Partner gesendet und auf die Ant wort gewartet wird Dieses Kommando hat dieselbe Wirkung wie die Kommandofolge SEND INVITE RECEIVE Das Kommando hat folgende Syntax EXEC CICS CONVERSE CONVID name FROM data area FROMLENGTH data value INTO data area TOLENGTH data value C MAXLENGTH data value J C NOTRUNCATE J Die Parameter haben die gleiche Bedeutung wie bei dem SEND bzw RECEIVE Kom mando beschrieben 112 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren ISSUE ABEND Mit diesem Kommando wird der Vorgang zum UTM Anwendungsprogramm abnormal beendet Der Aufruf entspricht dem UTM Aufruf CTRL AB Das Kommando hat folgende Syntax EXEC CICS ISSUE ABEND CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session ISSUE CONFIRMATION Mit
182. UNIX Systemen der die Application Entity d h den Access Point der zugeh rigen UTM Anwendung beschreibt rem_tns_name besteht aus funf Namensteilen jeweils durch Punkte getrennt NP5 NP4 NP3 NP2 NP1 Sind Namensteile leer k nnen Punkte am Namensende entfallen Im TNSX muss rem_tns_name als globaler Name eingetragen sein mit den Eigen schaften Transportadresse und Transportsystem Dabei m ssen neben einem T Selektor f r die Schicht 4 auch ein P und ein S Selektor eingetragen sein Diese m ssen zu den entsprechenden Parametern der ACCESS POINT Anweisung aus der UTM Generierung passen Es empfiehlt sich Leereintr ge f r S und P Selek toren zu w hlen REM AEQ rem_ae_qualifier Gibt den Application Entity Qualifier der UTM Anwendung an rem_ae_qualifier muss eine ganze Zahl sein zwischen 1 und 67108863 Sie muss dem Wert des AEQ Operanden aus der zugeh rigen ACCESS POINT Anweisung der UTM Ge nerierung entsprechen U5461 J Z135 6 49 openUTM LU62 generieren LU6 2 Kopplungen mit openUTM LU62 REM APT rem_ap_title Gibt den Application Process Title der UTM Anwendung in Form eines Objektbe zeichners an also in der Form n1 n2 n3 Dieser muss dem Wert des APT Operanden aus der zugeh rigen UTMD Anwei sung der UTM Generierung entsprechen REM LISTENER PORT rem_port Nur wenn kein TNSX verwendet wird dann aber Pflichtparameter TCP Portnummer der Partner UTM Anwendung mit dem G ltigkeitsb
183. UT NE KCRN gt A PEND FI FMH5 Daten gt RECEIVE STATE CRECEIVE RECEIVE STATE CONFFREE ISSUE CONFIRMATION RETURN lt Daten CEB F r diese Art der Kommunikation muss eine openUTM LU62 Instanz verwendet werden die mit dem Parameter UTM ASYNC YES generiert ist 144 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren Der in Beispiel 20 aufgef hrte Fall ist vom Ablauf her hnlich Der wesentliche Unterschied besteht darin dass das CICS Programm in Beispiel 20 noch Daten zur cksenden kann Auf UTM Seite hat der Dialog Fall den Vorteil dass die Anwendung ber Erfolg oder Mis serfolg des Aufrufs informiert wird Sendet das CICS Programm eine negative Verarbeitungsquittung mittels ISSUE ERROR so l scht openUTM den Auftrag Das UTM Anwendungsprogramm kann jedoch selbstver st ndlich nicht mehr benachrichtigt werden 24 Start eines CICS Asynchron Vorgangs aus einem UTM Anwendungsprogramm mit Transaktionssicherung INIT APRO AM KCPI gt A KCOF C FPUT NE KCRN gt A PEND FI FMH5 Daten Prepare gt gt RECEIVE STATE SYNCFREE SYNCPOINT lt RequestCommit Committed gt lt Forget NORMAL RETURN Setzt das CICS Programm die Transaktion zur ck mittels SYNCPOINT ROLLBACK so l scht openUTM den Auftrag Das UTM Anwendungsprogramm kann jedoch selbstver st ndlich nicht mehr benac
184. UTM Auftraggeber Vorgang gesen dete Nachricht zu empfangen Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim Lesen der Nachricht vom Auftraggeber CONVID nicht angegeben werden SEND Dieses Kommando sendet eine Dialogteilnachricht Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim Senden an den Auftraggeber CONVID nicht angegeben werden 116 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren CONVERSE Dieses Kommando bewirkt dass eine Nachricht an den Partner gesendet und auf die Ant wort gewartet wird Dieses Kommando hat dieselbe Wirkung wie die Kommandofolge SEND INVITE RECEIVE Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen ISSUE ABEND Mit diesem Kommando wird der Vorgang zum UTM Anwendungsprogramm abnormal beendet Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim ISSUE ABEND zum UTM Auftraggeber Vorgang CONVID nicht angegeben werden ISSUE CONFIRMATION Mit diesem Kommando wird eine positive Verarbeitungsquittung an das UTM Anwendungs programm gesendet Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim ISSUE CONFIRMATION zum UTM Auftraggeber Vorgang CONVID nicht angegeben wer den ISSUE ERROR Mit diesem Kommando wird eine Fehlermeldung oder negative Verarbeitungsquittung an das UTM Anwendungsprogramm
185. UTM erhaltene Nachrichten enthalten normalerweise in den ersten beiden Bytes ein L ngenfeld d h openUTM verwendet normalerweise das VLVB Format Wenn das UTM Anwendungsprogramm mehrere Teilnachrichten mit MPUT NT gesendet hat werden diese in einem RECEIVE Kommando empfangen Jeder Teil nachricht ist dann ein L ngenfeld vorangestellt Wenn das UTM Anwendungspro gramm beim MPUT KCDF ungleich 0 oder KCMF ungleich Leerzeichen gesetzt hat so sendet openUTM jedoch vor der Nachricht einen Function Management Header 4 FMH4 und die Daten ohne f hrendes L ngenfeld Mittels EXTRACT ATTACH kann das CICS Programm erfragen ob die Daten mit oder ohne L ngenfeld ankommen Genaueres zum EXTRACT ATTACH siehe Seite 225 Ob die angekom menen Daten einen FMH4 enthalten kann das CICS Programm an dem Indikator INBFMH nach Ausf hrung des RECEIVE Kommandos erkennen Genaueres zum FMH4 siehe ebenfalls Seite 225 NOTRUNCATE Ist NOTRUNCATE nicht angegeben so wird eine Nachricht bis zur L nge MAX LENGTH zugestellt Der Rest wird verworfen Ist NOTRUNCATE angegeben so k nnen weitere Teile mit RECEIVE angefordert werden Wegen der brigen Parameter siehe CICS for MVS ESA Application Programming Refe rence U5461 J Z135 6 223 CICS Kommandos f r CICS Auftraggeber Vorg nge openUTM CICS Kopplung ber LU6 1 CONVERSE Dieses Kommando bewirkt das s eine Nachricht an den Partner gesendet und auf die Ant wort des Partners gewartet wird
186. VB angegeben wurde muss ein 2 Byte langes L ngenfeld am Beginn der Nach richt stehen Mehrere Teilnachrichten k nnen mit einem SEND gesendet werden indem nach der ersten Teilnachricht erneut ein L ngenfeld vor die zweite Teilnach richt positioniert wird Wenn beim BUILD ATTACH Chain of RUs angegeben wur de Standardwert d rfen keine L ngenfelder am Beginn der Nachricht stehen INVITE veranlasst explizit dass mit dem Senden der Nachricht das Senderecht change direction an den Partner bertragen wird Das Eintreffen des Senderechts wird von openUTM als das Ende der Dialog Nachricht des Partners interpretiert 222 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r CICS Auftraggeber Vorg nge RECEIVE Dieses Kommando wird verwendet um eine von einem openUTM Vorgang gesendete Nachricht zu empfangen Das Kommando hat folgende Syntax EXEC CICS RECEIVE LSESSION name J CINTO bereich SET pntr LENGTH bereich LMAXLENGTH bereich ENOTRUNCATE SESSION name spezifiziert den Namen der Session Dieser ist als R ckgabewert aus dem ALLOCATE Kommando bekannt EIBRSRCE Die Nachricht kommt in diesem Fall vom Auftragnehmer alternate facility also vom UTM Anwendungsprogramm Wird die Option weggelassen so soll eine Nachricht vom Auftraggeber principal facility empfangen werden INTO bereich spezifiziert die Adresse des Speicherbereichs in den CICS die Nachricht schreiben soll Von
187. VIDO saga a a arena Bert Ahnen 115 DVE SIONAL c 3 2 2 80 2 88 OS ES RS AES aha in 115 CICS Kommandos f r CICS Auftragnehmer Vorg nge 116 EXTRACT PROUESS 251 be 6 86 be a e a a re 116 FCB E gon 0 08 0 ok he ek Bek Oe Re Be ee eam Beds 116 CEN eo ee eee ee en RAR A ee Ss Be Be 116 CONVERSE 4 23 8 20 ei OS EMEA EEA EE a Oe pe ew KS 117 SSVUEABENND 224 6 pak oe kkk Ge Gah ee ee ea Ob oh ER Sed BPS 117 ISSUE CONFIRMATION s s a i 0 0 2 saw Ba nad oe ee ee RRS A 117 E VE ERROR 2 0 38 0 08 0 2 0 0a Boa Ba a OE DEE RS HS 117 So OD lt 2 oe ae EI a Be ne 3 118 SV NGCPOINT ROLLBACK 465602608 Gee a Ged oe SED SESE Ee ES 118 PREE e a Beh Be hh He See ee I Ree Bee he Se ee 118 AAT COI 5 2 2 ea a ee aa ae een seh 118 PSM SIGE 22 u a a een a a ee 5 118 POVE PREPARE 2 528 22 50 SEE 44 b64 OR RSE Oe eee BE os 119 FUTUR s raa Skee eh Bik a we RES B S ES ha Rok Ro AO A 119 Hinweise zur CICS Programmierung 222m nn nn 120 Vergleich mit KDCS Aufrufen 2222 oaa 121 Beispiele f r openUTM CICS Kommunikation a aooaa 123 Start eines openUTM Dialogvorgangs aus einem CICS Anwendungsprogramm 123 Start eines UTM Asynchron Vorgangs aus einem CICS Anwendungsprogramm 131 Start eines CICS Dialogvorgangs aus einem UTM Anwendungsprogramm 133 Start eines CICS Asynchron Vorgangs aus einem UTM Anwendungsprogramm 144 Distributed Program Link sa ras tiect eddo rere tki dpdd rai 146 Hinweise zur openUTM Programmier
188. VISION DATA DIVISION WORKING STORAGE SECTION 77 GN FUNC PIC X 4 VALUE GN 01 IOAREA PIC X 256 LINKAGE SECTION 01 DIPC 02 DIPCDBN PIC X 8 02 DIPCLEVL PIC 9 2 02 DIPCSTAT PIC X 2 02 DIPCPROC PIC X 4 02 DIPCRESV PIC S9 5 COMP 02 DIPCSEGN PIC X 8 02 DIPCKFBL PIC S9 5 COMP 02 DIPCNSSG PIC S9 5 COMP 02 DIPCKFBA PIC X 20 PROCEDURE DIVISION ENTRY DLITCBL USING DIPC CALL CBLTDLI USING GN FUNC DIPC IOAREA IF DIPCSTAT NOT GOBACK 196 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren 5 2 2 5 2 3 5 2 4 5 2 5 Programmschnittstelle CPI C CPI C erm glicht die Nutzung des kompletten LU6 2 Umfangs Nur mit dieser Programm schnittstelle ist es m glich von IMS Programmen auch Synclevel Syncpoint Conversati ons zu Partnern aufzubauen Zur Steuerung des 2 Phase Commit muss in diesem Fall CPI RR verwendet werden F r weitere Informationen siehe auch Abschnitt Verwendung der Programmschnittstelle CPI C auf Seite 151 LU6 2 Edit Exit Routine Die LU6 2 Edit Exit Routine DFSLUEEO wird von IMS immer durchlaufen wenn ein DL I Programm eine LU6 2 Nachricht sendet oder empf ngt IBM liefert eine fertige Exit Routine aus die aber vom Kunden abge ndert werden kann Die Exit Routine kann zu folgenden Zwecken eingesetzt werden e nderung des Synchronization Level einer asynchronen LU6 2 Conversation e nderung von Nachrichteninhalten e L
189. X kann den Aufruf keinem Wartepunkt zuordnen U5461 J Z135 6 321 Meldungen des XAP TP Providers Meldungen von openUTM LU62 P013 Assoziation abgelehnt a_asscf amp ACPNT amp OSLPAP Grund amp XPCRES amp XPSRC amp XPNDIA CCR V2 amp XP1BOOL Version Incompatibility amp XP2BOOL ContWin Assignment rejected amp XP3BOOL Bid mandatory rejected amp XP4BOOL No reason amp XP5BOOL Diese Meldung wird ausgegeben wenn der aktive Aufbau einer Association vom fernen Partner abgelehnt wird Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPCRES gibt an ob die Ablehnung vor bergehend oder dauerhaft ist 0 permanent reject dauerhafte Ablehnung 1 transient reject vor bergehende Ablehnung amp XPCSRC gibt an wer den Aufbau abgelehnt hat 0 ACSE Service User 1 ACSE Service Provider 2 Presentation Service Provider amp XPNDIA siehe Tabelle auf Seite 341 amp XPIBOOL amp XPSBOOL k nnen die Werte TRUE und FALSE annehmen Die mit TRUE beleg ten Werte geben an welche Gr nde der Partner f r die Ablehnung des Associationsaufbauwunsches mitgeschickt hat amp XPIBOOL Die CCR Version 2 ist nicht verf gbar amp XP2BOOL Die TP Protokollversionen sind nicht kompatibel amp XP3BOOL Die Contention Winner Zuordnung wird abgelehnt amp XP4BOOL Die Festlegung Bidding ist Pflicht o
190. XAP TP Provider vergebene Instanz Deskriptor fd die Verarbeitungsrichtung und even tuelle weitere Parameter im Trace ausgegeben Die Verarbeitungsrichtung ist mit einem Pfeil gekennzeichnet Ein Pfeil nach rechts kennzeichnet eine von openUTM LU62 ausge hende Nachricht ein Pfeil nach links eine bei openUTM LU62 eingehende Nachricht Beim Start einer openUTM LU62 Instanz und w hrend der Commit Phase wird an der XAP TP Schnittstelle eine sogenannte Kontrollinstanz verwendet Diese Protokollfl sse sind mit einem einfachen Pfeil gt gekennzeichnet Alle anderen Protokollflusse sind mit einem Doppelpfeil gt gekennzeichnet Um die Zuordnung zwischen einer LU6 2 Conversation und einer parallelen Verbindung uber XAP TP zu erleichtern enthalt jede Nachricht eine Korrelationsnummer corr Proto kollflusse die keiner Conversation zugeordnet sind haben die Korrelationsnummer 0 AuBerdem wird zu jeder Nachricht jeweils die Uhrzeit und die Nummer der entsprechenden Zeile in der urpr nglichen Ausgabedatei ausgegeben Benutzerdaten sind im Protokoll Trace nicht enthalten Diese sind nur in der urspr nglichen Ausgabedatei zu finden 66 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren Im folgenden Beispiel eines Protokoll Trace sind zus tzliche Kommentare enthalten Diese Kommentare beziehen sich teilweise auf die im folgenden Kapitel verwendeten Begriffe z B die Namen von CICS Kommandos Das Be
191. _RCV_BTU_SIZE 1500 PORT_NAME IBMEEDLC PORT_TYPE SATF RETRY_LINK_ON_DISCONNECT 1 RETRY_LINK_ON_FAILED_START 1 RETRY_LINK_ON_FAILURE 1 FEN U5461 J Z135 6 187 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 DEFAULT_TG_CHARS COST_PER_BYTE 0 COST_PER_CONNECT_TIME 0 EFFECTIVE_CAPACITY 133 PROPAGAT ION_DELAY LAN SECURITY NONSECURE USER_DEF INED_1 0 USER_DEF INED_2 0 USER_DEF INED_3 0 PORT_OEM_SPECIFIC_DATA OEM_LINK_DATA OEM_DATA 010000000400000004000000030000000F00000000000000 OEM_DATA 0A0000000000000000 OEM_PORT_DEFAULTS OST_PER_CONNECT_TIME 0 FFECTIVE_CAPACITY 133 B_LINK_ACT_LIM 128 G INB_ OUT_LINK_ACT_LIM 127 D S T ROPAGATION_DELAY LAN ECURITY NONSECURE OT_LINK_ACT_LIM 255 LINK_STATION IVATE_AT_STARTUP 1 CTIVATION_DELAY_TIMER 1 DJACENT_BRANCH_EXTENDER_NODE PROHIBITED DJACENT_NODE_TYPE LEARN UTO_ACTIVATE_SUPPORT 0 RANCH_EXTENDER_LINK 1 P_CP_SESS_SUPPORT 1 FAULT_NN_SERVER 0 LAY_APPLICATION_RETRIES 0 PENDENT_LU_COMPRESSION 0 PENDENT_LU_ENCRYPTION OPTIONAL ST_ADDRESS F45519AC BLE_REMOTE_ACT 0 PU_SERVICES NONE _ADJACENT_CP_NAME P390 P390SSCP R_LINK_LVL_ERROR 0 R_SUPPORT 1 HERIT_PORT_RETRY_PARMS 1 on n gt IInmO oO 00 0 OOD gt gt gt gt gt I S A E TEETE I HH LIMITED_RESOURCE NO LINK_DEACT_TIMER 600 LINK_STATION
192. _ROLE NEGOTIABLE 188 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren LS_NAME P390SSCP MAX_ACTIVATION_ATTEMPTS 1 MAX_IFRM_RCVD 7 MAX_SEND_BTU_SIZE 1500 NODE_ID 05D25129 NULL_ADDRESS_MEANING USE_WILDCARD PORT_NAME IBMEEDLC PU_NAME P390SSCP RETRY_LINK_ON_DISCONNECT 0 RETRY_LINK_ON_FAILED_START 0 RETRY_LINK_ON_FAILURE 0 REVERSE_ADDRESS_BYTES 0 SOLICIT_SSCP_SESSION 0 TG_NUMBER 0 USE_DEFAULT_TG_CHARS 1 USE_PU_NAME_IN_XID 0 TG_CHARS COST_PER_BYTE 0 COST_PER_CONNECT_TIME 0 EFFECTIVE_CAPACITY 0 PROPAGATION_DELAY MINIMUM USER_DEFINED_1 0 USER_DEFINED_2 0 USER_DEFINED_3 0 LINK_STATION_OEM_SPECIFIC_DATA OEM_LINK_DATA OEM_DATA 010000000400000004000000030000000F00000000000000 OEM_DATA 0A000000F45519AC DLUR_DEFAULTS DEFAULT_PU_NAME MHPBO2GC DLUS_RETRY_LIMIT 3 DLUS_RETRY_TIMEOUT 5 LOCAL_LU LU_NAME IMSJ DEFAULT_POOL 0 LU_ALTAS IJWIMSJ LU_SESSTON_LIMIT 0 NAU_ADDRESS 0 ROUTE_TO_CLIENT 0 SYNCPT_SUPPORT 1 U5461 J Z135 6 189 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 MODE MODE_ AUTO_ COMPR COS_ ENCRY MAX_I MAX_ MAX_O DEFAU AME APPCHOST ACT 6 ESSION PROHIBITED AME CONNECT LT_RU_SIZE 0 PTION_SUPPORT NONE COMING_COMPRESSION_LEVEL NONE EGOTIABLE_SESSION_LIMIT 128 UTGOING_COMPRESSION_LEVEL NONE MAX_RU_SIZE_UPPER_BOUND 4096 MIN_C PLU_M RECEI PA
193. _SIZE 32767 PARALLEL_SESSION_SUPPORT 1 PARTNER_LU_ALIAS CICST6 PREFERENCE USE_DEFAULT_PREFERENCE ADJACENT_NODE FQ_CP_NAME DESNI000 M88 LU_ENTRY ILDCARD_LU 0 Q_LU_NAME DESNI000 A9CICST6 m 4 SPLIT_STACK POOL_NAME lt Keine gt STARTUP 1 SHARED_FOLDERS EXTENSION_LIST CACHE_SIZE 256 VERIFY CFG_MODIFICATION_LEVEL 12 CFG_VERSION_LEVEL 1 CFG_LAST_SCENARIO 20 3 43 10 43 20 10 43 3 43 96 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren nderung bei Verwendung von SNAP IX IBM Communications Server for Linux oder IBM Communications Server for AIX Bei Verwendung von SNAP IX IBM Communications Server for Linux oder IBM Commu nications Server for AIX anstelle von TRANSIT m ssen Generierungsparameter in der Syn tax dieses Produktes definiert werden Generierung von SNAP IX bzw IBM Communications Server for Linux bzw IBM Communications Server for AIX Ldefine_node_config_file major_version 5 minor_version 1 update_release 1 revision_level 47 Ldefine_node cp_alias PO2CGE 17 description SNAP IX Knoten fqcp_name DESNIO00 PO2CGE 17 43 node_type LEN_NODE ode_to_cos_map_supp YES ds_supported YES node_id lt 0172000E gt 11 12 ax_locates 1500 dir_cache_size 255 ax_dir_entries 0 locate_timeout 0 reg_with_nn YES reg_with_cds YES
194. aher den OSI TP Dialogwunsch ab Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Shared Control gewuenscht openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit der Funktionseinheit Functional Unit Shared Control empfangen Da diese Funktionalit t von openUTM LU62 nicht unterst tzt wird wird der OSI TP Dialog abgebrochen Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Codierung des fernen Application Process Title fehlerhaft openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit einem fehlerhaft codierten APT application Process Title bzw AEQ Applica tion Entity Qualifier erhalten Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Typ des fernen Application Entity Qualifier fehlerhaft Siehe Kommentar zur Meldung 365 Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber CCR Syntax fuer die Partner Anwendung nicht vereinbart openUTM LU62 hat vom OSI TP Partner d h von der UTM Anwendung eine TP_BEGIN_DIALOGUE indication mit der Functional Unit Commit empfangen ob wohl ein Application Context UDTAC oder UDTDISAC konfiguriert wurde und damit keine Transaktionss
195. amm mit Wer ten versorgt werden Nach einem erfolgreichen INFO GN sind die Felder durch openUTM bereits richtig fur eine Antwort in einem Pseudodialog belegt U5461 J Z135 6 251 Programmschnittstelle f r openUTM LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen INFO GN Die folgende Tabelle zeigt die notwendigen Angaben im KDCS Parameterbereich bei INFO GN KCOP KCOM KCLA INFO GN 32 Alle anderen Parameterfelder m ssen auf bin r null gesetzt werden COBOL Format des Aufrufs CALL KDCS USING lt parml gt lt parm2 gt lt parm1 gt KDCS Parameterbereich lt parm2 gt Datenbereich openUTM gibt folgendes zur ck BeiKCRCCC 000 sind die Felder KCRDPN und KCRPRN im Datenbereich lt parm2 gt mit Leerzeichen belegt KCDPN und KCPRN enthalten das Ziel in der anderen Anwen dung aus der Eingabe Nachricht KCRLM enth lt die Lange des Datenbereichs 32 bei KCRCCC gt 40Z ist die Lange 0 Das R ckgabefeld KCRCCC kann einen der folgende Werte enthalten 000 Die Funktion wurde ausgef hrt 40Z Die Funktion kann nicht durchgef hrt werden die Namen sind nicht vorhanden KCRCDC enth lt KD20 41Z Der Aufruf ist an dieser Stelle nicht erlaubt INFO GN wurde in einem Dialogvorgang gegeben INFO GN wurde in einem Vorgang gegeben der nicht von einer fernen An wendung gestartet wurde 42Z KCOM ist ung ltig 43Z KCLA ist ung ltig 47Z Die Adresse des Datenbereichs fehlt bz
196. artner in der Session ist Zwischen zwei LUs auf Hostsystemen oder PUs vom Typ 2 1 k n nen gleichzeitig mehrere Sessions parallele Sessions aufgebaut werden Man spricht hierbei auch von independent Sessions Man beachte dass der Begriff Session in der OSI Protokollwelt eine andere Bedeutung als die hier beschriebene hat 368 U5461 J Z135 6 Fachw rter Side Information Side Information bezeichnet bei der Programmschnittstelle CPI C die f r den Ablauf von CPI C Programmen notwendige Konfiguration InopenUTM wird die Side Information mit den Steueranweisungen f r KDCDEF beschrieben F r CPI C Programme die unter IMS ablaufen muss eine eigene Side Information Datei vom Systemverwalter bereitgestellt werden Symbolic Destination Name Unter Symbolic Destination Name versteht man bei der Programmschnittstelle CPI C einen symbolischen Namen mit dem man aus dem Programm heraus eine ferne Transaktion adressieren kann Uber die Side Information wird die sem symbolischen Namen ein konkreter Transaktionscode in einer konkreten fernen Anwendung zugeordnet Das Konzept ist vergleichbar dem von ope nUTM verwendeten LTAC Sync Level Synchronisation level Bezeichnung bei LU6 2 die die Transaktionssicherheit bei verteilter Verarbei tung charakterisiert Bei Sync Level 0 None d rfen nur Nettodaten und Fehlermeldungen gesendet werden Quittungen sind nicht zul ssig Dies entspricht bei openUTM KCOF B beim APRO Bei Sync Level 1 Co
197. artner kalt gestartet werden um die Situation zu bereinigen Genaueres hierzu siehe Meldung 421 308 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 424 425 LU6 2 Partner meldet Protokollfehler Zustand amp STAT1 amp STATE2 TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Der LU6 2 Partner ist der Meinung dass openUTM LU62 gegen das LU6 2 Proto koll verstoBen hat Wenn der ProtokollverstoB im normalen Betrieb gemeldet wird f hrt dies zu einem R cksetzen der Transaktion Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Wenn der Protokollfehler reproduzierbar ist das Ganze mit Trace wiederholen und den Systemdienst verst ndigen Es ist m glich dass Datenbank Inkonsistenzen entstanden sind M glicherweise m ssen auch die openUTM LU62 Instanz und der LU6 2 Partner kalt gestartet werden um die Situation zu bereinigen Genaueres hierzu siehe Meldung 421 Fehlerhafter Log Record Fehlertyp amp ERROR Transaktion wird geloescht LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Beim Warmstart von openUTM LU62 wurde ein fehlerhafter Log Record eingele sen Die in diesem Log Record beschriebene Transaktion kann deshal
198. ateien auf Das Programm hat vom Betriebssystem nicht gen gend Spei cherplatz erhalten Diese Fehlermeldung kann durchaus vorkommen wenn der Trace Level gr er oder gleich 4 war so dass das Programm u62_tp auch Trace Eintr ge in einer Interrupt Behandlung geschrieben hat Wenn das gerade beim Schreiben eines anderen Trace Eintrags passiert wird die interne Struktur der Tra ce Datei zerst rt Interner Fehler aufgetreten Fehler beim Schliessen der Tracedatei amp FILENAME errno amp ERRNO amp ERRTXT Diese Meldung dient nur der Information des Aufrufers und hat sonst keine weitere Bedeutung die Auswertung ist ja bereits abgeschlossen Fehler beim Schliessen des Meldungskatalogs amp CATNAME errno amp ERRNO amp ERRTXT Diese dient Meldung nur der Information des Aufrufers und hat sonst keine Auswir kungen da die Auswertung aller angegebenen Trace Dateien bereits erfolgt ist U5461 J Z135 6 353 Meldungen von u62_adm Meldungen von openUTM LU62 58 59 60 80 81 82 83 84 Fehler beim Extrahieren des Nachrichtenflusses mittels amp FUNCTION errno amp ERRNO amp ERRTXT Das Extrahieren des Protokoll Trace kann einige Zeit dauern Bitte warten Diese Meldung erscheint immer wenn u62_adm f p aufgerufen wurde um aus der Trace Datei das Protokoll zwischen openUTM LU62 und seinen Kommunika tionspartnern UTM Anwendung und LU6 2 Partner z B CICS zu extrahieren Da dies als Shell Sk
199. aten die jedoch von openUTM LU62 verworfen werden Diese Meldung gibt den Hinweis dass eine ankommende Conversation vom LU6 2 Partner Initialisierungsdaten mitgeliefert hat die jedoch nicht zum OSI TP Partner d h zur UTM Anwendung weitergereicht werden k nnen berpr fen Sie das Anwendungsprogramm des LU6 2 Partners Wenn die Initialisierungsdaten f r die Anwendungslogik ben tigt werden ist keine sinnvolle Kommunikation m glich amp TPNAME bezeichnet den UTM Transaktionscode U5461 J Z135 6 283 Meldungen des Programms u62_tp Meldungen von openUTM LU62 304 305 306 307 Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Security Daten werden vom OSI TP Partner nicht unterstuetzt oder enthalten un gueltige Zeichen Eine vom LU6 2 Partner ankommende Conversation zum TP amp TPNAME enth lt Security Daten Benutzerkennung und eventuell Passwort und kann nur dann zum OSI TP Partner d h zur UTM Anwendung weitergereicht werden wenn auch die ser eine Sicherheitspr fung unterst tzt Dies ist jedoch nur dann der Fall wenn APPL CONTEXT UDTSEC konfiguriert ist Bei allen anderen Application Con texts oder bei einem Fehler bei der ASN1 Codierung der Security Daten weist openUTM LU62 die Conversation sofort mit dem Fehlercode AP_SECURITY_PARAMS_INVALID zur ck amp TPNAME bezeichnet den UTM Transaktionscode Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist
200. b des ZLU6 1 Protokolls wie die Benutzerdaten zu transferie ren sind Chain of RUs legt fest dass Benutzerdaten in Bl cke mit maximal der Gr e von RU Size aufzutrennen sind Der erste Block erh lt den Indikator Begin of Chain der letzte End of Chain alle anderen Middle of Chain Alternativ k nnen die Benutzerdaten auch als VLVB transferiert werden Im UTM Anwendungsprogramm sind diese beiden Alternativen nicht sichtbar im CICS Anwendungsprogramm sind sie jedoch sichtbar 360 U5461 J Z135 6 Fachw rter Cluster Controller Synonym f r Typ 2 0 Knoten jedoch mehr aus der Hardware Sicht Typisches Beispiel ist eine 3174 von IBM Common Programming Interface for Communication CPI C Von IBM und X Open definierte Programmschnittstelle f r die LU6 2 und OSI TP Kommunikation Common Programming Interface for Resource Recovery CPI RR Von IBM definierte Programmschnittstelle f r Transaktionssicherung CPI RR wird blicherweise in Programmen gemeinsam mit der Programmschnittstelle CPI C genutzt X Open hat anstelle der CPI RR die Programmschnittstelle TX definiert Communication Controller Synonym f r Typ 4 Knoten jedoch mehr aus der Hardware Sicht Entspricht in etwa einem BS2000 OSD Vorrechner Typisches Beispiel ist eine 3745 von IBM Compare States Bei LU6 2 verwendetes Protokollelement das im Falle eines Verbindungsab bruchs oder Rechnerabsturzes die gemeinsame Transaktion synchronisiert C
201. b nicht resynchronisiert werden Zur Bedeutung von LUWID und AAID siehe Meldung 402 Wenn vom vorhergehenden Lauf von openUTM LU62 noch irgendwelche Diag noseunterlagen vorhanden sind sichern Sie diese und stellen Sie sie dem System dienst zur Verf gung Es ist m glich dass Datenbank Inkonsistenzen entstanden sind M glicherweise m ssen auch die openUTM LU62 Instanz und der LU6 2 Partner kalt gestartet werden um die Situation zu bereinigen Genaueres hierzu siehe Meldung 421 U5461 J Z135 6 309 Meldungen des Programms u62_tp Meldungen von openUTM LU62 426 427 Problem an der XAP TP Schnittstelle amp EVENT erhalten An der XAP TP Schnittstelle die zur Kommunikation zwischen openUTM LU62 und UTM Anwendung benutzt wird ist ein Fehler aufgetreten Verst ndigen Sie den Systemdienst Fehler lt amp ERRNR beim Aufruf von amp CALL Bei einem UNIX Systemaufruf ist ein Fehler aufgetreten Dies kann zu einer abnor malen Beendigung von openUTM LU62 f hren Meldungen der Komponente RS 510 511 Die LU Alias Name amp ALIASNAME Netzname amp NETNAME hat eine negative Antwort auf eine Exchange Logname Nachricht gesendet Diese LU hat einen warm kalt oder einen Log Namen Fehler festgestellt Die ferne LU identifiziert durch den Alias Namen amp ALIASNAME in der LU6 2 Basis Software z B TRANSIT bzw durch den Netzwerknamen amp NETNAME im SNA Netz hat einen schwerwiegenden Fehler beim Austausc
202. bei einer Initialisierung der Session durch den Operator mit Hilfe des OPN Kommandos ben tigt Z B wird die Session mit dem SUBPOOL 1181 mit folgendem Aufruf aufgebaut OPN NODE UTM1S SUBPOOL I1S1 ID 11X1 Die Zuordnung zwischen TERMINAL und SUBPOOL ist bei IMS nicht fest sondern erfolgt dynamisch anhand der Daten des Verbindungsaufbaus 242 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 1 TRANSIT Generierung f r openUTM IMS Sessions 7 2 TRANSIT Generierung f r openUTM IMS Sessions Die Aussagen zu TRANSIT die zur openUTM CICS Kopplung gemacht wurden gelten analog f r die openUTM IMS Kopplung Siehe hierzu Seite 214 7 3 Generieren von IMS Transaktionen Makro TRANSACT Mit diesem Makro werden IMS Transaktionen definiert Er entspricht der TAC Anweisung in der UTM Generierung TRANSACT CODE transaction code MSGTYPE MULTSEG RESPONSE Die Operanden haben folgende Bedeutung CODE transaction code 1 8 Zeichen langer Name f r die IMS Transaktion Dieser Name muss mit dem RTAC Operanden in der korrespondierenden LTAC Anweisung der UTM Generie rung Ubereinstimmen MSGTYPE MULTSEG RESPONSE MULTSEG definiert dass eine Eingabe Nachricht aus mehreren Segmenten beste hen kann RESPONSE wird f r Dialog Programme angegeben NONRESPONSE f r Asynchron Programme Der Parameter SPA darf nicht verwendet werden Beispiele LTAC IMSDIAIP TRANSACT RTAC DIALOGI CODE DIALOGI TYPE D MSGTY PE MULT
203. beispiel 25 29 TRANSIT SERVER 25 37 Generierung LU6 2 Kopplung 80 88 Transmission Header 214 370 Transportselektor 47 TRMSGLTH 238 240 TX 151 361 Typ 2 0 Knoten 370 Typ 2 1 Knoten 29 370 Typ 4 Knoten 370 Typ 5 Knoten 370 TYPE Makro 238 U u62_adm 53 57 61 62 64 u62_gen 52 53 u62_sta 58 u62_start 55 u62_svc 39 u62_tp 39 Meldungen 264 U62_TRC_FILES 64 u62_wlog 39 UDP 371 UDT 150 UDTAC 45 UDTCCR 45 UDTDISAC 45 UDTSEC 45 Unterstreichung 21 USER IMS CNTL 184 Userid IMS 183 Userid siehe Benutzerkennung U5461 J Z135 6 401 Stichw rter UTM Anwendung 14 Z UTM ASYNC 51 Zeitmessung 55 63 UTM Generierung Zeit berwachung 45 IMS Beispiel f r LU6 2 192 Zustandsinformationen 58 openUTM CICS Kopplung LU6 2 81 90 92 UTMD Anweisung 50 UTMGW1 214 V Verarbeitungsquittung bei CICS 111 113 117 129 143 bei CPI C 159 173 Verbindung abbauen 61 aufbauen 61 Verbindungsverlust 40 VLVB 210 221 225 239 371 Vorgangsende 111 Vorgangsstatus 123 Vorgangswiederanlauf 234 VTAM 371 VTAM Generierung 80 87 IMS Beispiel LU6 2 185 IMS LU6 2 Kopplung 181 VTAMPOOL Makro 240 WwW Warmstart 40 Lukewarm 56 Wiederanlauf 40 234 Windows Systeme IBM CS Gateway f r LU6 2 Kopplung 32 LU6 2 Kopplung ber SNAP IX 28 Write Log D mon 39 Write Log Programm 39 x XAP TP Provider Meldungen 316 XAP TP Trace 55 63 65 XMODE Anweisung 45 402 U5461 J Z135 6 Fujitsu Technology Solutions
204. belegt werden und die aktuelle Transaktion befindet sich in der Endphase Zu diesem Zeitpunkt k nnen keine weite ren OSI TP Dialoge mehr an den Transaktionsbaum angegliedert werden U5461 J Z135 6 291 Meldungen des Programms u62_tp Meldungen von openUTM LU62 351 XAP TP Provider meldet Verlust der Assoziation TP amp TPNAME source amp SRC reason amp RSN event amp EVT openUTM LU62 hat eine ankommende Conversation vom LU6 2 Partner ange nommen und bereits eine parallele Verbindung f r einen OSI TP Dialog zum TP amp TPNAME des OSI TP Partners d h zum Transaktionscode amp TPNAME der UTM Anwendung erfolgreich belegt Bevor es jedoch zum OSI TP Dialogaufbau kommt geht die parallele Verbindung wieder verloren openUTM LU62 bricht dar aufhin die Conversation zum LU6 2 Partner ab Bedeutung von amp SRC ACSE Service User ACSE Service Provider Presentation Service Provider NIN Oo APM Service Provider Association Pool Manager Bedeutung von amp RSN bei amp SRC gleich 0 oder 1 1 A RELEASE IND kein Grund angegeben 0 A RELEASE IND normaler Release Request 1 A RELEASE IND dringender Release Request 12 A ABORT IND 30 A RELEASE IND benutzerdefinierter Release Request Bedeutung von amp RSN bei amp SRC gleich 2 1 kein Abbruchgrund angegeben Abbruchgrund nicht bekannt unbekannte Presentation Protocol Data Unit
205. c Adresse Zahl zwischen 1 und 255 Einer LU entspricht bei openUTM in etwa ein BCAMAPPL oder ein ACCESS POINT LU6 1 Protokoll Das LU6 1 Protokoll ist Bestandteil der IBM Netzwerkarchitektur SNA und defi niert Methoden zur verteilten Transaktionsverarbeitung LU6 1 wurde von IBM entwickelt f r die verteilte Verarbeitung zwischen CICS und IMS Anwendungen auf Hostsystemen Da es auch in open UTM implementiert ist kann es auch f r die verteilte Verarbeitung zwischen openUTM und CICS und zwischen openUTM und JMS benutzt werden IBM betrachtet LU6 2 als Nachfolger von LU6 1 LU6 2 Protokoll Das LU6 2 Protokoll ist Bestandteil der IBM Netzwerkarchitektur und ist dort das neueste und modernste Protokoll LU6 2 definiert Methoden f r eine Pro gramm Programm Kommunikation zwischen Anwendungen in verschiedenen Rechnern LU6 2 kann mit und ohne Transaktionssicherung benutzt werden Es bietet vielf ltige Security Mechanismen Logical Unit of Work LUW Dieser Begriff wird in der IBM Literatur verwendet anstelle des bei openUTM blichen Begriffs Transaktion Eine logical unit of work kann Rechner lokal oder Rechner bergreifend sein U5461 J Z135 6 365 Fachw rter Logical Unit of Work Identifier LUWID Log Name Bei LU6 2 erh lt jede Rechner bergreifende Transaktion einen netzweit und langfristig eindeutigen Namen die sogenannte LUWID Der Initiator der Trans aktion vergibt diesen Namen Mit seiner Hilfe k nnen sich im Fa
206. cedt name belegt F r den UTM Anwender hei t das Angabe von SESCHA DPNa iscedt name und Ber cksichtigung des Transaktionscodes bei der Definition des Eingabebereiches Der Transaktionscode wird von openUTM nicht aus den Daten entfernt Wird die Angabe DPN iscedt name nicht gemacht so kann als TAC auch der iscedt name verwendet werden Dieser kann dazu benutzt werden um z B zu n chst gemeinsame Funktionen f r mehrere Transaktionen durchzuf hren ehe die eigent liche Transaktion Name aus den Daten zum Ablauf kommt Als Antwort auf eine asynchrone Anfrage verh lt sich IMS wie openUTM nach einem INFO GN Die Parameter RDPN RPRN der Eingabe werden bei der Ausgabe durch IMS auf die Felder DPN PRN gesetzt Soll von IMS ein Pseudodialog gestartet werden so muss das Feld RPRN mit dem Trans aktionscode des Empf ngers in IMS belegt werden Standardm ig enth lt dieses Feld den Namen des aufrufenden Terminals oder Programmes Andere Werte m ssen ber MFS belegt werden Behandlung des Transaktionscodes in CICS CICS kann die einzelnen Felder bei Asynchronauftr gen individuell durch Parameter im START Aufruf belegen START TRANSID T1 DPN TERMID T2 PRN RTRANSID T3 RDPN RTERMID T4 RPRN CICS schickt den Transaktionscode normalerweise im Feld DPN CICS empf ngt Daten von openUTM mit dem RETRIEVE Kommando Der TAC wird aus dem Feld DPN entnommen RETRIEVE TRANSID T1 RDPN TERMID T2 lt
207. chen langen Namen den Half Session Qualifier identifiziert Diese Namen werden in den Generierungen der entsprechenden Anwendungen festgelegt bei openUTM durch LSES und RSES Eine Session ist durch die beiden Half Session Qualifier eindeutig identi fiziert Bei LU6 2 gibt es keine Half Session Qualifier Im SNA Sprachgebrauch Synonym f r Typ 5 Knoten Independent LU dependent LU Eine logical unit LU in einem Typ 2 0 Knoten ist immer eine dependent LU Sie ist abh ngig vom SSCP System Service Control Point im zugeh rigen Typ 5 Knoten Eine dependent LU kann h chstens eine Session zu einer LU im zuge h rigen Typ 5 Knoten aufbauen Sie ist bei dieser Session immer Secondary LU Dependent LUs gibt es f r alle LU Typen also unter anderem auch f r LU6 1 und LU6 2 Ein Typ 2 1 Knoten kann dagegen dependent und independent LUs beinhalten Eine independent LU kann nur das LU6 2 Protokoll nutzen Sie kann jedoch zu mehreren Partnern gleichzeitig Sessions unterhalten und zu einem Partner bis zu 254 parallele Sessions Information Management System IMS Transaktionsmonitoun DatenbanksystenvonBMIMSaufhuaufemBM GroBrech ner Betriebssystem z OS IMS besteht aus den beiden zentralen Komponenten IMS Database Management System IMS DB IMS Transaction Manager IMS TM IMS TM ist ein mit openUTM vergleichbarer Transaktionsmonitor Initiator Sync point initiator Bei verteilter Transaktionsverarbeitung mit LU6 2 der Kommunikati
208. cherung CMINIT CMSSL CM_CONFIRM CMALLC CMSST CM_SEND_AND_PREP_TO_RECEIVE CMSEND FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MGET KCRMGT H MPUT NE PEND FI lt Daten CEB CM_OK CMRCV CM_DEALLOCATED_NORMAL U5461 J Z135 6 159 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 9 Negative Verarbeitungsquittung ohne Transaktionssicherung CMINIT CMSSL CM_CONFIRM CMALLC CMSST CM_SEND_AND_PREP_TO_RECEIVE CMSEND FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MGET KCRMGT H MPUT EM PEND FI lt FMH7 CM_PROGRAM_ERROR_PURGING CMRCV CM_DEALLOCATED_NORMAL Start eines UTM Asynchron Vorgangs aus einem CPI C Anwendungsprogramm 10 Mit Transaktionssicherung CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND CMDEAL SRRCMIT FMH5 Daten RequestCommit gt lt Committed RR_OK INIT FGET PEND FI openUTM sendet die Quittungsnachricht sofort nachdem es den Asynchron Auftrag erhal ten und gesichert hat Je nach Verf gbarkeit von Systemressourcen kann es bis zur Aus f hrung des Asynchronauftrags einige Zeit dauern 160 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 11 Ohne Transaktionssicherung CMINIT CMSSL CM_CONFIRM CMALLC CMSEND CMDEAL FMH5 Daten gt lt Quittung
209. dary Logical Unit SLU Bei den logical units LUs unterscheidet man zwischen primary logical units PLU und secondary logical units SLU PLU bzw SLU Status zweier LUs werden beim SNA Sessionaufbau BIND festgelegt Mit Hilfe von Generie rungsparametern wird eine Voreinstellung bez glich der primary secondary Eigenschaft festgelegt Bei openUTM geschieht dies im Generierungsparame ter SESCHA bei LU6 1 Verbindungen Bei LU6 2 und independent LUs gibt es blicherweise keine Voreinstellung per Generierung Die primary logical unit sendet bei Sessioner ffnung Vorschl ge f r die Sessionparameter im soge nannten BIND Request Die secondary logical unit akzeptiert diese Vorschl ge oder sendet Gegenvorschl ge BIND Response Principal Facility Bezeichnung f r den Standard Kommunikationspartner eines CICS Pro gramms d h den Partner der das Programm aufgerufen hat Gegenteil Alternate facility Bei openUTM verwendet man stattdessen den Begriff Auftrag geber U5461 J Z135 6 367 Fachw rter RACF Resource Access Control Facility RACF ist ein Produkt der Firma IBM mit dessen Hilfe im GroBrechner Umfeld der Zugriffsschutz auf alle Anwendungen und Ressourcen gesteuert wird RACF ist somit zust ndig f r Identifikation und Verifikation der User mittels Benutzerschl ssel und Pass wortpr fung Authentifizierung Schutz von Ressourcen durch die Verwaltung der Zugriffsrechte Autorisie rung Logging der Zug
210. dem auch als gebundene Papierexemplare bestellt werden Zus tzlich werden die pdf Dateien auf der openUTM Produkt DVD ausgeliefert Die folgenden Abschnitte geben einen Aufgaben bezogenen berblick ber die Dokumen tation zu openUTM V5 3 Eine vollst ndige Liste der Dokumentation zu openUTM finden Sie im Literaturverzeichnis auf Seite 377 Einf hrung und berblick Das Handbuch Konzepte und Funktionen gibt einen zusammenh ngenden berblick ber die wesentlichen Funktionen Leistungen und Einsatzm glichkeiten von openUTM 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 14 U5461 J Z135 6 Einleitung Wegweiser durch die Dokumentation zu openUTM Programmieren 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 universellen Transak tionsmonitors als auch die Aufrufe f r verteilte Verarbeitung Es wird auch die Zusam menarbeit mit Datenbanken beschrieben Wollen Sie die X Open Schnittstellen nutzen ben tigen Sie das Handbuch Anwen dungen erstellen mit X Open Schni
211. den MODENAME mode_name Maximal achtstelliger Mode Name der auf den Verbindungen zur LU6 2 Anwen dung benutzt werden soll Er muss in der Konfiguration der LU6 2 Basis Software TRANSIT SERVER SNAP IX bzw IBM Communications Server sowie beim Part nersystem ebenfalls definiert sein Der Mode Name SNASVCMG darf nicht ver wendet werden 48 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren OSITP CODE Beschreibung des Zeichensatzes in dem die Benutzerdaten der UTM Anwen dungsprogramme codiert sind ASCII Die UTM Anwendungsprogramme verwenden den ASCII 8 Bit Zei chensatz ISO 8859 1 Dies ist blich f r UTM Anwendungspro gramme auf UNIX oder Windows Systemen EBCDIC BS2 Die UTM Anwendungsprogramme verwenden die in BS2000 OSD bliche EBCDIC Variante EBCDIC DF 04 Latin 1 NO openUTM LU62 f hrt keine Code Konvertierung der Benutzerdaten durch Dieser Wert muss angegeben werden wenn die UTM An wendungsprogramme Bin rdaten also z B bin re Langenfelder bertragen Standardwert openUTM LU62 f hrt eine Codekonvertierung aller Benutzerdaten durch wenn bei OSITP CODE und LU62 CODE unterschiedliche Zeichens tze generiert sind Bei NO f hrt openUTM LU62 keine Codekonvertierung durch Ist hier NO angege ben so muss auch bei LU62 CODE NO angegeben werden REM AE rem_tns_name Nur bei Verwendung von TNSX Maximal 18 stelliger globaler Name aus dem TNSX Transport Name Service in
212. den WAIT CONVID Das Kommando sorgt daf r dass zuvor mittels SEND erstellte Daten tats chlich abgesen det werden Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen ISSUE SIGNAL Wie beim Auftraggeber Vorgang beschrieben sollte das Kommando nicht angewendet werden 118 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren ISSUE PREPARE Das Kommando darf in einem Auftraggeber Vorgang nicht abgesetzt werden RETURN Das Kommando RETURN impliziert das Senden noch nicht gesendeter Nachrichten mit einem Sicherungsrequest an den Partner und anschlie ender Sessionfreigabe Das RETURN Kommando ist nur zul ssig wenn der openUTM Auftraggeber Vorgang bereits CTRL PE oder PEND FI gegeben hat Indikator EIBFREE im EIB oder nachdem das CICS Programm mittels ISSUE ABEND den Vorgang abnormal beendet hat Das Kommando hat folgende Syntax EXEC CICS RETURN U5461 J Z135 6 119 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 2 3 Hinweise zur CICS Programmierung Bei einer openUTM CICS Kopplung gibt es noch Einschr nkungen gegen ber dem bei sonstigen LU6 2 Kopplungen verf gbaren Funktionsumfang 1 Die LU6 2 Kommunikation zwischen CICS und openUTM kann bei CICS nur mit Hilfe von DTP Distributed Transaction Processing programmiert werden Asynchronous Processing mittels START und RETRIEVE oder Distributed Program Link mittels EXEC CICS LINK
213. der Bidding ist nicht Pflicht wird abgelehnt amp XP5BOOL Es wird kein Grund angegeben 322 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des XAP TP Providers P014 Fehler beim Assoziationsaufbau amp XPFUNC P015 amp ACPNT amp OSLPAP amp XPRET amp XPERR amp XP1INFO amp XP2INFO Diese Meldung wird ausgegeben wenn der Aufruf einer OSS Funktion die zum Aufbau einer Association ben tigt wird einen Fehler liefert Handelt es sich um einen vom Transportsystem gemeldeten Fehler wird zus tzlich die Meldung P012 ausgegeben Ist es kein vom Transportsystem gemeldeter Fehler wird die Anwen dung mit Termapplication beendet Die Inserts haben folgende Bedeutung amp XPFUNC Name der OSS Funktion amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPRET siehe Tabelle auf Seite 334 amp XPERR siehe Tabelle auf Seite 334 amp XPIINFO OSS Zusatzinformation amp XP2INFO OSS Zusatzinformation zur Zeit immer Null Assoziation abgebaut amp XPFUNC amp ACPNT amp OSLPAP amp XPLNK amp XPSRC amp XPNDIA amp XPINI amp XP1INFO amp XP2INFO Diese Meldung wird ausgegeben wenn eine Association abgebaut wird Die Inserts haben folgende Bedeutung amp XPFUNC Name der OSS Funktion amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPLNK reprasentiert den internen Zustand d
214. des Wertebereichs Wert fuer CONNECT zu gross Fehler in Anweisung vor Zeile amp LINENO Wert fuer CONTWIN zu gross Fehler in Anweisung vor Zeile amp LINENO Der Wert von CONNECT bzw CONTWIN berschreitet den durch den Generie rungsparameter ASSOCIATIONS vorgegebenen Maximalwert von parallelen Verbindungen OSITP CODE und LU62 CODE inkonsistent nur einer von beiden NO Fehler in Anweisung vor Zeile amp LINENO TNS Name amp NAME ist unzulaessig Fehler in Zeile amp LINENO Name amp NAME bereits vergeben Fehler in Zeile amp LINENO U5461 J Z135 6 355 Meldungen von u62_gen Meldungen von openUTM LU62 31 33 34 35 36 37 38 39 40 41 42 43 47 48 50 51 Der aus APT und AEQ gebildete lokale AE Title ist bereits vergeben Fehler in Anweisung vor Zeile amp LINENO Mode Name amp MODENAME ist unzulaessig Fehler in Zeile amp LINENO SNASVCMG ist ein reservierter Name und darf nicht als gew hnlicher Mode ange geben werden Pflichtparameter LOC LU ALIAS fehlt Pflichtparameter REM LU ALIAS fehlt Pflichtparameter MODENAME fehlt Pflichtparameter LOC APT fehlt Pflichtparameter REM APT fehlt Pflichtparameter LOC AEQ fehlt Pflichtparameter REM AEQ fehlt Die Konfiguration der lokalen OSI Adresse ist unvollstaendig Es fehlt der Parameter LOC AE bzw einer der Parameter LOC TSEL LOC LISTENER PORT Die Konfiguration der entfernten OSI Adresse ist unvollstaendig Es fehlt der Parameter
215. det wird der O PCB benutzt Zum Senden einer Nachricht an einen Auftrag nehmer muss ein Alternate PCB benutzt werden bei dem vorher mit dem Aufruf CHNG eine neue Zieladresse gesetzt wird Bestandteil des PCB ist der Partner bp Folgende Partner Typen sind m glich APPC LU6 2 Partner O Area ist der Nachrichtenbereich OTMA TCP IP Partner TERMINAL Terminal oder LU6 1 Partner TRANSACTION Transaktionscode U5461 J Z135 6 195 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 dest name Destination Name LTERM oder Transaktionscode Name des Partners opt list Options list Bei CHNG k nnen hier Parameter des LU6 2 Partners angegeben werden n mlich LU Name MODE Name TP Name und Sync Level none oder confirm Alternativ kann auch ein Symbolic Destination Name angegeben werden Bei LU6 2 Kommu nikation erfolgt die Adressierung entweder ber opt list oder ber einen LTERM Na men im Feld dest name Bei SETO wird hier angegeben ob Send_Error oder Deallocate_Abend gesendet werden soll mod name Message output descriptor name Formatname aib Application Interface Control Block Dieser enth lt die PCB Adresse und einige Zusatzinformationen token Name eines R cksetzpunktes Es ist m glich auch l ngere Dialoge abwechselnd mit GU GN und ISRT zu programmie ren Beispielhafter Auszug aus einem DL I COBOL Programm GN Aufruf ID DIVISION ENVIRONMENT DI
216. deutungen SESSIONS session_name Name der Sessions Definition Dieser Name kommt nur in den CICS Definitionen vor GROUP group_name 1 8 Zeichen langer Name Der CICS Systemverwalter muss diesen Namen verge ben Er kommt nur in den CICS Definitionen vor Es sollte derselbe Name wie in der zugeh rigen Connection Definition gew hlt werden CONNECTION connection_name Name der zugeh rigen CONNECTION Definition SESSNAME loc_ses_name 1 4 Zeichen langer Name mit dem der local half session qualifier festgelegt wird Dieser Name muss mit dem RSES Operanden in der korrespondierenden LSES Anweisung der UTM Generierung bereinstimmen NETNAMEQ rem_ses_name 1 8 Zeichen langer Name mit dem der remote half session qualifier festgelegt wird Dieser Name muss mit dem LSES Namen in der korrespondierenden LSES Anwei sung der UTM Generierung bereinstimmen PROTOCOL LU61 Es wird eine LU6 1 Session definiert U5461 J Z135 6 211 CICS Definitionen f r openUTM CICS Sessions openUTM CICS Kopplung ber LU6 1 RECEIVECOUNT SENDCOUNT Hiermit wird bestimmt welcher Partner PLU und wer SLU ist In der UTM Anwen dung werden die entsprechenden Angaben in der SESCHA Anweisung gemacht RECEIVECOUNT 01 SENDCOUNT leerzeichen F r diese Session ist die CICS Anwendung PLU primary logical unit und conten tion loser In der korrespondierenden SESCHA Anweisung der UTM Generierung muss PLU Y CONTWIN N angegeben werden RECEIVECOUNT leerzeichen
217. dieren Ungiltiger PPDU Parameter z B falsche Lange Dieser abort kann vom UTM Benutzer durch die Angabe von ung ltigen Presentation Session Selektoren ausgel st werden 406 O_REM_PRES Der Verursacher ist der ferne Presentation Provider amp XP1INFO kann folgende Werte annehmen 1 O_NOVALUE optional parameter is not present 0 P_ARNNO reason not specified 1 P_ARNRPDU unrecognized PPDU 2 P_ARNEPDU unexpected PPDU 3 P_ARNESSP unexpected session service primitive 4 P_ARNRPAR unrecognized PPDU parameter 5 P_ARNEPAR unexpected PPDU parameter 6 P_ARNIPAR invalid PPDU parameter value 407 O_LOC_ACSE Der Verursacher ist der lokale ACSE Provider amp XP1INFO hat immer den folgenden Wert 1 A_ABSASP ACSE service provider initiated the abort Es wird die Instanz angegeben die aus ACSE Sicht den abort ausgel st hat abort source 408 O_REM_ACSE Der Verursacher ist der entferne ACSE Service Provider amp XP1INFO kann folgende Werte annehmen 0 A_ABSASU ACSE service user initiated the abort 1 A_ABSASP ACSE service provider initiated the abort 328 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers P016 Assoziation abgebaut a_relin amp ACPNT amp OSLPAP amp XPLNK amp XPNDIA Diese Meldung wird ausgegeben wenn eine Association abgebaut wird weil eine release indication empfangen
218. e 1 8 Zeichen langer Name Der CICS Systemverwalter muss diesen Namen verge ben Er kommt nur in den CICS Definitionen vor NETNAME netname 1 8 Zeichen langer Name unter dem die UTM Anwendung im SNA Netz bekannt ist Dieser Name muss mit dem LNETNAME Operanden in der korrespondierenden LPAP Anweisung der UTM Generierung bereinstimmen ACCESSMETHOD VTAM Zugriffsmethode VTAM PROTOCOL LU61 Es wird eine LU6 1 Verbindung definiert DATASTREAM USER Die Benutzerdaten werden vollstandig vom Anwenderprogramm definiert RECORDFORMAT U VB Das Format muss mit der Satzform wie sie von CICS geschickt wird korrespondie ren Der Standardwert U unformatted entspricht S tzen ohne L ngenfeld Wird VB variable blocked angegeben dann m ssen die von CICS bereitgestellten S tze dem von LU6 1 definierten VLVB Format entsprechen d h sie m ssen L n genfelder enthalten 210 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Definitionen f r openUTM CICS Sessions DEFINE SESSIONS Hiermit wird eine LU6 1 Session definiert Dies entspricht der LSES Anweisung in der UTM Generierung DEFINE SESSIONS session_name GROUP group_name CONNECTION connection_name SESSNAME loc_ses_name ETNAMEQ rem_ses_name PROTOCOL LU61 RECEIVECOUNT 01 leerzeichen SENDCOUNT 01 leerzeichen SENDSTZE ru_size RECEIVESIZE ru_size AUTOCONNECT NO YES BUILDCHAIN YES IOAREALEN valuel value2 Die Operanden haben folgende Be
219. e SRO ee 226 Be rs art e Ges oh ches ok Se ee Gide he i Re ed he ce ee te A 226 CICS Kommandos f r CICS Auftragnehmer Vorgange 5 227 RECENE lt ne Ee aise can ohn tes apes ee ete pcre se Re ee ee fee kai eo A 227 EATRACTAITTACH 20 oe eae aS Bowe Ged Oe OER RAS oD oe OSS SS 227 BUILD ATACH e at ook Lesh Ee kha a Ses 444 SSE ES 228 SEND gh A ier ac ae ea a cis me AD de Sede rae hk ak Rhye Gohan aie Moka ak Bok ew 228 CONVERSE ea ah ee ee ard hE Sie Be Be A eee Be GS Mae eee 4 229 BVNGPOIN 2 za zu deo KSEE REESE ERR RS oR A 229 RETURN 2 sadn ede te aces a oe eee Sh Goh BO a ee we Be a 229 Vergleich mit KDCS Aufrufen 22200 mn nn nn 230 Programmbeispiele f r CICS openUTM Kommunikation 231 CICS Kommandos f r Asynchron Auftr ge 2 2m nennen 232 EEE re ENE E ee A WR ee ee er E ee ne ee he op 232 RETRIEVE 2s k hA Rew a CRASS OD SUAS GOR ade 233 Beispiele f r den Austausch von Asynchron Auftragen 233 Hinweise zur openUTM CICS Programmierung 22220 234 openUTM IMS Kopplung ber LU6 1 nn nun nn 237 IMS Generierung f r openUTM IMS Sessions 222m une 237 ME OHEN sorted rski a era a rar Bra aS Se 238 Makro TYPE 62 ae 2 en ee ee we oe es we oe a Be a ee a 238 Makro TERMINAL 2 a cc coe bomen Sahoo eee eee wee eee we Ee 239 Makro VTAMPOOL 2 0 00 ce 240 Mako SUBPOOL 2 4 eh 83 ES eR OR AE Ee OEE OE eee oe OSS 240 Makro NAME a ee ee ee ee a we a a a 241
220. e Verbindung wegen falscher Header oder Parameter lange Systemfehler abgebaut 448 T_RLCONGEST Das lokale CCP hat die Verbindung wegen Betriebsmittelengpass abgebaut 449 T_RLNOQOS Das lokale CCP hat die Verbindung abgebaut weil Quality of Service nicht mehr unterst tzt wird 451 T_RILLPWD Ung ltiges Verbindungspasswort 452 RNETACC Netzzugang wurde verweigert 464 T_RLPROTERR Das lokale CCP hat die Verbindung wegen eines Transportprotokollfehlers Systemfehler abgebaut 465 T_RLINTIDU Das lokale CCP hat die Verbindung abgebaut weil es eine zu lange Schnittstellen Dateneinheit erhalten hat Systemfehler 466 T_RLNORMFLOW Das lokale CCP hat die Verbindung wegen Verletzung der Flusskontrollregeln f r Normaldaten Systemfehler abgebaut U5461 J Z135 6 325 Meldungen des XAP TP Providers Meldungen von openUTM LU62 XPINI Bedeutung 467 T_RLEXFLOW Das lokale CCP hat die Verbindung wegen Verletzung der Flusskontrollregeln f r Vorrangdaten Systemfehler abgebaut 468 T_RLINSAPID Das lokale CCP hat die Verbindung abgebaut weil es eine ung ltige TSAP Iden tifikation erhalten hat Systemfehler 469 T_RLINCEPID Das lokale CCP hat die Verbindung abgebaut weil es eine ung ltige TCEP Iden tifikation erhalten hat Systemfehler 470 T_RLINPAR Das lokale CCP hat die Verbindung wegen eines unzul ssigen Parameterwerts z B Benutzerdaten zu lang oder V
221. e 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 Anwendungspro gramm bindet und startet wie man sich bei einer UTM Anwendung an und abmeldet und wie man Anwendungsprogramme strukturiert und im laufenden Betrieb austauscht Au er dem enth lt es die UTM Kommandos die dem Terminal Benutzer zur Verf gung stehen 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 und ber die M glichkeiten der zentralen Administration mehrerer An wendungen Dar ber hinaus beschreibt es wie Sie 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 Ob
222. e in eine der beteiligten Daten banken notwendig um die inkonsistenten Datenbankst nde wieder zu koordinie ren 304 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 407 408 LU6 2 Partner meldet resync in progress TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Der LU6 2 Partner hat die Transaktion z B nach einem Verbindungsverlust eigen standig beendet ohne auf die UTM Anwendung zu warten Es ist nicht bekannt ob die Transaktion inkonsistent ist oder nicht Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Die Verwalter der an der Transaktion beteiligten Datenbanken sollten pr fen ob eine Datenbank Inkonsistenz entstanden ist OSI TP Partner meldet heuristischen Mix TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Der OSI TP Partner d h UTM Anwendung oder die Datenbank auf UTM Seite hat die Transaktion z B nach einem Verbindungsverlust eigenstandig beendet ohne auf den LU6 2 Partner zu warten Die Transaktion ist damit inkonsistent Datenbankan derungen auf UTM Seite und auf LU6 2 Seite die durch die Transaktion koordiniert werden sollten wurden fe
223. eAS OC4J Deployer EJB Entwickler und CICS Administratoren BizTransactions Anwendungsintegration mit Business Objekten Online Beschreibung im Internet verf gbar Zielgruppe Alle die mit Business Objekten openUTM MVS oder OSD Anwendungen in Java Win dows oder openSEAS integrieren wollen JConnect V2 0 Verbindung von Java Clients zu openUTM Benutzerdokumentation und Java Docs nur online verf gbar Internet Zielgruppe Programmierer von Java Anwendungen WebTransactions Konzepte und Funktionen Online Beschreibung im Internet verf gbar Zielgruppe Alle die UTM MVS oder OSD Anwendungen ans Web anbinden wollen WebTransactions Template Sprache Online Beschreibung im Internet verf gbar Zielgruppe Alle die UTM MVS oder OSD Anwendungen ans Web anbinden wollen U5461 J Z135 6 381 Literatur WebTransactions Anschluss an openUTM Anwendungen ber UPIC Online Beschreibung im Internet verf gbar Zielgruppe Alle die UTM Anwendungen ber UPIC ans Web anbinden wollen WebTransactions Anschluss an MVS Anwendungen Online Beschreibung im Internet verf gbar Zielgruppe Alle die MVS Anwendungen ans Web anbinden wollen WebTransactions Anschluss an OSD Anwendungen Online Beschreibung im Internet verf gbar Zielgruppe Alle die OSD Anwendungen ans Web anbinden wollen 382 U5461 J Z135 6 Literatur Dokumentation zum BS2000 OSD Umfeld AID BS2000 OSD Advanced Interactive Deb
224. ebenslauf des openUTM LU62 Prozesses es sei denn eine Verbindung wird mittels Administrationskommando abgebaut Wird die bei CONNECT angegebene Zahl von Verbindungen von der Partner UTM Anwendung aufgebaut so baut openUTM LUB62 keine zus tzlichen Verbindungen auf CONTWIN cwin_number Anzahl der Verbindungen zur UTM Anwendung in der openUTM LU62 Contention Winner ist Die Summe aus cwin_number und dem Wert des CONTWIN Parameters aus der zugeh rigen OSI LPAP Anweisung der UTM Generierung sollte genau ass_number ergeben LOC AE loc_tns_name Nur bei Verwendung von TNSX Maximal 18 stelliger globaler Name aus dem TNSX Transport Name Service in UNIX der die Stellvertreter AE beschreibt loc_tns_name besteht aus f nf Namens teilen jeweils durch Punkte getrennt NP5 NP4 NP3 NP2 NP1 Sind Namensteile leer k nnen Punkte am Namensende entfallen Im TNSX muss loc_tns_name als globaler Name eingetragen sein mit der Eigen schaft Lokaler Name Dabei m ssen neben einem T Selektor f r die Schicht 4 auch ein P und ein S Selektor eingetragen sein Diese m ssen zu den entspre chenden Parametern einer OSI CON Anweisung aus der UTM Generierung pas sen Es empfiehlt sich Leereintr ge f r S und P Selektoren zu w hlen LOC AEQ loc_ae_qualifier Gibt den Application Entity Qualifier der Stellvertreter AE an loc_ae_qualifier muss eine ganze Zahl sein zwischen 1 und 67108863 Sie muss dem Wert des AEQ Operanden aus der zugeh rig
225. efiniert werden und die Auswahl der verschiedenen Sessions muss ber das UTM bzw CICS Anwendungspro gramm gesteuert werden 212 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Definitionen f r openUTM CICS Sessions Beispiel zu Abh ngigkeiten von CICS und UTM Generierung CICS Definitionen Sil APPLID C I1CSCGKe _ ___ kaani UTM Generierung SESCHA PLU PLU Y CONTWIN N CONNECT Y DEFINE CONNECTION UTMS DEFINE N S R N S S R LPAP CICSP s RNETNAME C ICSCGK ETNAME UTMMCHP ESSIONS PCS1 ONNECTION UTMS ECEIVECOUNT Ol gt LNETNAME UTMMCHP m SESCHA P LU gt LSES UTS1 ETNAMEQ UTSI1 ESSNAME CIPl LPAP CICSP ENDSIZE 1024 ECEIVESIZE 1024 RSES CIP1 MAX NB 1024 1 CON Statement U5461 J Z135 6 213 TRANSIT Generierung f r openUTM CICS Sessions openUTM CICS Kopplung ber LU6 1 6 2 TRANSIT Generierung f r openUTM CICS Sessions Das openUTM Gateway 1 UTMGWI1 benutzt eine interne Schnittstelle von TRANSIT SERVER Dabei werden die LU6 1 Protokolle von openUTM transparent durchgereicht Zus tzlich wird der Sessionauf und Abbau und die Umwandlung des Transmission Header FID1 FID2 behandelt Die Kommunikation mit dem UTM System erfolgt ber CMX Die Kommunikation mit der IBM Applikation erfolgt ber TRANSIT SERVER und je nach Kopplungsart ber CMX oder direkt ber den UNIX
226. egeben u62_adm ruft zu diesem Zweck die awk Prozedur u62_f1ow auf Dieser Pro tokoll Trace wird im folgenden Abschnitt genauer beschrieben 64 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren Beispiel Sind im Dateiverzeichnis des UNIX Systems opt 1ib utm1u62 PROT die Trace Dateien inlog TO2CGEI4 0 und inlog TO2CGEI4 1 vorhanden so k nnen Sie diese mit folgenden Kommandos auswerten cd opt 1ib utmlu62 PROT u62_adm fpo outfile inlog TO2CGEI4 0 inlog TO2CGEI4 1 Es werden dadurch die Dateien outfile und outfile flow im Dateiverzeichnis opt 1ib utml u62 PROT angelegt Zur Auswertung des XAP TP Trace steht das folgende Kommando zur Verf gung opt lib oss step tracefile tracefile2 step bereitet die XAP TP Traces auf und gibt sie in lesbarer Form nach stdout aus Auf Windows Systemen steht step unter Programme utm u62 3 3 9 Dump erzeugen In manchen Fehlersituationen kann es erforderlich sein als Hilfsmittel f r die Fehlerdiagno se Zustandsinformationen von openUTM LU62 in Form eines Dumps zu sichern Hierzu dient folgendes Kommando opt lib utmlu62 u62_adm b in xap Dadurch werden folgende Dateien angelegt opt 1ib utml u62 PROT in dump loc_lu_alias 1 opt 1ib utml u62 PROT xap dump loc_lu_alias 1 DIAGOO Auf Windows Systemen liegen die Dateien entsprechend unter Programme utm1u62 PROT Mit jedem Aufruf von u62_adm b wird der Z hler der im obigen Beispie
227. ei ten siehe das Handbuch TRANSIT SERVER U5461 J Z135 6 25 Direkte LU6 2 Kopplung ber SNAP IX auf Solaris Kopplung mit IBM Systemen 2 2 Direkte LU6 2 Kopplung ber SNAP IX auf Solaris Die folgende Kopplungsm glichkeit kann eingesetzt werden wenn die UTM Anwendung auf einem Solaris Rechner l uft der direkt an das SNA Netz angebunden ist Solaris Rechner IBM Rechner CICS oder IMS openUTM oder TXSeries CMX SNA Basis Software openUTM LU62 z B VTAM SNAP IX Enterprise Extender SNA ber IP Direkte LU6 2 Kopplung mit openUTM auf Solaris und Einsatz von SNAP IX Im Bild ist eine SNA Kopplung ber Enterprise Extender SNA ber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu SNAP IX 26 U5461 J Z135 6 Kopplung mit IBM Systemen Direkte LU6 2 Kopplung ber IBM Communications Server 2 3 Direkte LU6 2 Kopplung ber IBM Communications Server auf Linux oder AIX Systemen Die folgende Kopplungsm glichkeit kann eingesetzt werden wenn die UTM Anwendung auf einem Linux oder AlX Rechner l uft der direkt an das SNA Netz angebunden ist Linux bzw AIX Rechner IBM Rechner CICS oder IMS openUTM oder TXSeries PCMX SNA Basis Software z B VTAM openUTM LU62 IBM Communications Server Enterprise Extender SNA ber IP Direkte LU6 2 Kopplung mit openUTM auf
228. eigt das erste Beispiel die Verwen dung von EXEC CICS LINK zwischen 2 CICS Systemen Im zweiten Beispiel wird der Distributed Program Link von einem System mit CICS Client aufgerufen Bei CICS Client wird die Programmschnittstelle External Call Interface ECI benutzt 146 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 1 Distributed Program Link zwischen zwei CICS Systemen CICS System 1 CICS System 2 openUIM gt RECEIVE Client LINK SYSIDC TRANSID gt gt ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND INVITE WAIT CONVID ee gt INIT PU MGET MPUT NE PEND KP ste NORMAL RECEIVE CONVID RETURN PEN hs NORMAL SYNCPOINT gt gt INIT PU MGET PEND RE Se ee ee ar od SSS gt AA gt INIT PU MGET PEND FI Pee eet Ann pe Le ee NORMAL SEND Client Zur RETURN ENDTA 0 SEND Y VGST 0 TAST 0 ENDTA R SEND N KCRLM 0 VGST 0 TAST P ENDTA F SEND N KCRLM 0 VGST 0 TAST P U5461 J Z135 6 147 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 2 Distributed Program Link von CICS Client CICS Client CICS 6000 CICS_ExternalCall program m gt LINK SYSI TRANS NORMAL SEHEN SEIEN ECI_NO_ERROR CICS_ExternalCall ECI_COMMIT nm gt Eu wo dan DG 4 TDG CICS ESA openUTM ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 2 SEND I
229. eil er den Calling Application Process Title nicht kennt CALLING_AE_QUALI_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Calling Application Entity Qualifier nicht kennt CALLING_AP_INVOC_ID_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Calling Application Process Invocation Identifier nicht kennt CALLING_AE_INVOC_ID_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Calling Application Entity Invocation Identifier nicht kennt CALLED_AP_TITLE_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Called Application Process Title nicht kennt CALLED_AE_QUALI_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Called Application Entity Qualifier nicht kennt CALLED_AP_INVOC_ID_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Called Application Process Invocation Identifier nicht kennt 10 CALLED_AE_INVOC_ID_NOT_RECON Der Partner lehnt den Associationsaufbauwunsch ab weil er den Called Application Entity Invocation Identifier nicht kennt 11 PERMANENT_FAILURE Der Partner baut die Association ab weil ein permanenter Fehler aufgetreten ist 12 BEGIN_TRANSACTION_REJECT Der Partner baut die Association ab weil er den Beginn einer Transaktion ablehnt U5461 J Z135 6 341 Insert XPNDIA Meldungen von openUTM LU62
230. eilter Transaktionsverarbeitung mit LU6 2 der Kommunikationspartner der vom anderen Partner die Aufforderung zum Sync Point Transaktionsende erh lt Alternate Facility Bezeichnung f r einen Kommunikationspartner eines C CS Programms zu dem es die Kommunikation selbst mittels Allocate aufgebaut hat Gegenteil Principal facility Bei openUTM verwendet man stattdessen den Begriff Auftrag nehmer Anynet Name einer Familie von IBM Produkten die die MPTN Protokolle realisieren MPTN steht f r Multiprotocol Transport Networking und erm glicht es Anwen dungen die f r ein bestimmtes Transportprotokoll geschrieben wurden auf anderen Transportprotokollen ablaufen zu lassen Wichtigstes Beispiel ist APPC ber TCP IP manchmal auch SNA ber TCP IP oder SNA IP genannt Damit k nnen sich zwei APPC Anwendungen ber ein TCP IP Netz hinweg unterhalten Um dies zu erm glichen muss in beiden Endsystemen ein Anynet Produkt installiert sein Auf Windows Systemen bietet das Produkt IBM Communications Server for Windows diese Funktionalit t Assoziation Association In der OSI Begriffswelt eine Kommunikationsbeziehung zwischen zwei Applica tion Entities In openUTM wird anstelle des Begriffs Assoziation meist der Begriff parallele Verbindung benutzt Einer Assoziation entspricht bei SNA eine Session U5461 J Z135 6 359 Fachw rter Attach Header Siehe Function Management Header Back end Transaction Backout
231. eim Starten einer Instanz von openUTM LU62 werden im Dateiverzeichnis utm1u62 PROT folgende Diagnosedateien gel scht in dump uname xap1og luname xap dump duname prot luname old inlog luname old core luname Die Dateien prot luname und in1og luname werden mit dem Suffix o1d versehen Auf Windows Systemen hat die Datei prot luname zus tzlich das Suffix txt 258 U5461 J Z135 6 Fehlerdiagnose LU6 1 Sense Data 9 2 LU6 1 Sense Data Im folgenden Abschnitt sind die Sense Data beschrieben die von openUTM bei einer LU6 1 Kopplung gesendet werden 0006 0000 0007 0000 0809 xxxx 080B 0000 0812 0000 0813 0000 0814 0000 0819 0000 081B 0000 082D 0000 0835 xxxx 0846 0000 084B 0000 084D xxxx 0864 0101 0864 0104 0864 0106 0864 0107 LUSTAT NOOP LUSTAT QUEUE EMPTY MODE INCONSISTENCY BRACKET RACE ERROR INSUFFICIENT RESOURCE Betriebsmittelengpass z B Pagepool voll BRACKET BID REJECT Eine Sessionbelegungsanforderung von der Con tention Loser Anwendung wurde abgelehnt da die Contention Winner An wendung die Session f r einen Auftrag belegt hat BRACKET BID REJECT RTR FOLLOWS RTR NOT REQUIRED TRANSMISSION RACE Eine Sessionbelegungsanforderung von der Con tention Loser Anwendung wurde abgelehnt da die Contention Winner An wendung die Session f r einen Auftrag belegt hat LU BUSY INVALID PARAMETER xxxx ist die Adresse des fehlerhaften Parameters innerhalb des empfangene
232. eint auf dem Bildschirm die folgende Meldung u62_start 17 openUTM LU62 gestartet u lokaler LU Alias Name TO2CGEIA4 PID 1771 Start Typ w Die Werte bei lokaler LU Alias Name und PID sind dabei durch aktuelle Werte ersetzt 56 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren 3 3 3 Normalerweise wird man openUTM LU62 immer beim Systemstart starten und beim Sy stem Shutdown beenden wollen Auf UNIX Systemen wird dies erreicht durch die Datei etc rc2 d S30u62 bzw eine gleichnamige Datei in einem anderen System RC Verzeich nis Auf Windows Systemen kann w hrend der Installation ausgew hlt werden ob openUTM LU62 als Service gestartet werden soll Wird dies ausgew hlt so startet das Betriebssy stem immer beim Hochfahren automatisch alle Instanzen von open UTM LU62 Sollen bei diesem automatischen Start Parameter bergeben werden so m ssen diese ber den Re gistrierungseditor des Betriebssystems in die Variable U62_SERVICE_ARGS im Verzeichnis HKEY_LOCAL_MACHINE SOFTWARE Siemens openUTM LU62 CurrentVersion eingetragen werden Wenn Sie eine Instanz ber die Dienste Administration des Windows Systems starten wird U62_SERVICE_ARGS nicht ausgewertet Stattdessen m ssen die Startparameter von Hand eingetragen werden Wollen Sie ohne Neuinstallation erreichen dass openUTM LU62 als Service gestartet wird so k nnen Sie hierzu auch folgendes Kommando verwenden u62_start r
233. eit von openUTM LU62 jedoch nicht ndert darf dies nur in der Startphase vorkommen Unbekannte Meldung Ox amp HEX vom Write Log Daemon empfangen u62_tp hat eine interne Nachricht mit dem unbekannten Nachrichtentyp amp HEX 4 stellig hexadezimal vom Write Log D mon empfangen Diese Meldung deutet entweder auf einen Kommunikationsfehler zwischen u62_tp und dem Write Log Daemon oder auf eine fehlerhafte Installation von openUTM LU62 hin inkompati ble Versionen von u62_tp und u62_wlog Der Write Log Daemon mit PID amp PID ist abgestuerzt Das Programm u62_tp Uberwacht in regelmaBigen Abstanden ob der von ihm gestartete Write Log Damon mit der PID amp PID noch am Leben ist Wird der Tod des D mons festgestellt so wird die Meldung 064 ausgegeben und u62_wlog erneut gestartet Write Log Daemon mit PID amp PID gestartet Diese Meldung bedeutet keinen Fehler sondern protokolliert nur die PID des so eben mittels fork erzeugten Kind Prozesses der allerdings noch mittels exec mit dem Programm u62_wlog berlagert werden muss Die maximale Anzahl amp ANZ erfolgloser Versuche den Write Log Daemon zu star ten ist ueberschritten u62_tp hat inzwischen mehrmals hintereinander in immer gr eren Zeitintervallen erfolglos versucht den Write Log Damon u62_wlog zu starten Ist die maximale Anzahl amp ANZ solch erfolgloser Versuche erreicht beendet sich u62_tp Fehler beim Starten des Write Log Daemons mittels fork e
234. elen Verbindungen von openUTM LU62 Gene rierungsparameter ASSOCIATIONS erh ht werden 341 Ankommender Dialog zum OSI TP Partner abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Ablauf des Timers zur Ueberwachung des Conversationaufbaus Der OSI TP Partner d h die UTM Anwendung hat einen OSI TP Dialog zum TP amp TPNAME aufgebaut amp TPNAME bezeichnet also z B den CICS Transaktions code openUTM LU62 kann jedoch im Moment aufgrund eines Mangels an freien Sessions keine Conversation zum LU6 2 Partner aufbauen Wird innerhalb einer bestimmten Wartezeit keine Session frei so weist openUTM LU62 den OSI TP Dialog zur ck Diese maximale Wartezeit ist in openUTM LU62 mit dem Parameter ALLOC TIME konfigurierbar der Standardwert betr gt 30 Sekunden Erscheint die se Meldung h ufiger so sollte entweder das Sessionlimit in TRANSIT der Gene rierungsparameter SESS MAX bei XMODE erh ht oder die Anzahl der parallelen Verbindungen von openUTM LU62 Generierungsparameter ASSOCIATIONS erniedrigt werden 290 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 350 XAP TP Provider lehnt Assoziationswunsch ab TP amp TPNAME result amp RES source amp SRC reason amp RSN openUTM LU62 hat eine ankommende Conversation vom LU6 2 Partner ange nommen und versucht eine parallele Verbindung f r einen OSI TP Dialog zum TP amp TPNAME des OSI TP Partners d h zum Transaktionscode amp TPN
235. eln 4 Eine Session zwischen einem UTM und einem CICS Vorgang ist an einer Sicherung beteiligt und darf nicht ohne Sicherungspunkt freigegeben werden 5 In Bezug auf Beendigung einer Sessionfreigabe Bracket sind bei openUTM der Auf tragnehmer und der Auftraggeber Vorgang nicht gleichberechtigt Der Auftraggeber Vorgang darf vor seinem Auftragnehmer Vorgang nicht als erster mit PEND FI die Freigabe der Session einleiten Deshalb darf ein CICS Vorgang bei Zusammenarbeit mit einem UTM Vorgang nur dann als erster die Sessionfreigabe einleiten wenn er Auf tragnehmer ist 218 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Programmierung bei Kopplung mit openUTM 6 Indikatoren f r Sicherungspunkte Sessionbeendigung oder Wechsel in SEND bzw RECEIVE Zustand werden bei openUTM in der Nachricht gesendet CICS Komman dos und ihre Kombinationen die das Senden von isolierten Indikatoren d h ohne Nachrichteninhalt an openUTM veranlassen k nnen d rfen nicht verwendet werden z B WAIT Option bei SEND in CICS for MVS ESA Application Programming Refe rence Das Eintreffen des Senderechts change direction oder von end bracket wird von openUTM als Ende der Nachricht interpretiert Erst danach wird sie als eine vollst ndi ge Nachricht angesehen und das Zielprogramm wird aktiviert Das Hinzuf gen des change direction Indikators zur Nachricht kann mit den CICS Kommandos CONVERSE oder SEND INVITE erreicht werde
236. en OSS SINIX OSI Session Service User Guide Zielgruppe OSI TP Anwender PRIMECLUSTER Konzept Solaris Linux Benutzerhandbuch Zielgruppe Benutzer und Systemadministratoren 388 U5461 J Z135 6 Literatur Dokumentation zu TRANSIT Die TRANSIT Handb cher sind online zu finden unter http manuals fujitsu siemens com softbooks software de prevtsit htm TRANSIT SERVER Administration von TRANSIT Basishandbuch Teil 1 und 2 Zielgruppe Fur openUTM LU6 2 Kopplung und openUTM LU6 1 Kopplung Systemverwalter die f r den Einsatz von TRANSIT unter UNIX Systemen verantwortlich sind TRANSIT CLIENT Programmierschnittstelle LUO LUO API FTX LU UTMGW1 Programmierhandbuch Zielgruppe Fur openUTM LU6 1 Kopplung Anwendungsprogrammierer und TRANSIT Adminstrato ren U5461 J Z135 6 389 Literatur Dokumentation zu CICS und IMS Die folgende Liste gibt eine unverbindliche bersicht ber die IBM Literatur zu CICS und IMS Die Literaturliste bezieht sich auf die Versionen CICS Transaction Server for z OS V3 1 und IMS Version 9 CICS Intercommunication Guide Das Dokument beschreibt die unterschiedlichen M glichkeiten in CICS zur Kommunikation mit anderen Anwendungen Unter anderem enth lt es die grundlegenden Konzepte des Distributed Transaction Processing hinsichtlich Installation Konfiguration und Programmie rung CICS Distributed Transaction Programming Guide Dieses Dokument beschreibt al
237. en das Routing der Antworten zu automatisieren Dabei wird das Ziel der Antwort bei der Anfrage mitgeliefert und so eine M glichkeit f r einen Pseudodialog geschaffen Die Informationen f r das Routing werden im function management header 6 FMH6 hinterlegt und m ssen vom Partner ausgewertet werden Der Zugriff auf die Daten im FMH6 von openUTM aus wird im Kapitel Pseudo dialoge zwischen Asynchron Vorg ngen beschrieben 244 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 1 IMS Programmierung bei Kopplung mit openUTM 7 4 2 7 4 3 IMS Aufrufe IMS Programme senden und empfangen Nachrichten durch folgende Aufrufe GU lt I O PCB gt lt I O area gt empf ngt die erste oder einzige Teilnachricht in dem Bereich lt I O area gt GN lt I O PCB gt lt I O area gt empf ngt gegebenenfalls weitere Teilnachrichten in dem Bereich lt I O area gt CHNG lt Alt PCB gt lt destination name gt ndert die Zieladresse in lt destination name gt Iterm aus NAME Makro der Generierung ISRT lt I O PCB gt lt Alt PCB gt lt I O area gt lt MOD Name gt sendet Nachrichten aus dem Bereich lt I O area gt RETURN beendet die Transaktion und fordert einen Sicherungspunkt an Beim Empfangen und Senden einer Nachricht wird ein PCB program communication block bergeben in dem Informationen wie Status Partnername Iterm usw abgespei chert werden Wird eine Nachricht an den Partner gesendet der eine Transaktion aufgeru fe
238. en OSI LPAP Anweisung der UTM Generierung ent sprechen 46 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren LOC APT loc_ap_title Gibt den Application Process Title der Stellvertreter AE in Form eines Objektbe zeichners an also in der Form n1 n2 n3 Dabei kann n die Werte 0 1 oder 2 und n2 die Werte 0 bis 39 annehmen Der Application Process Title muss dem Wert des APT Operanden aus der zugeh rigen OSI LPAP Anweisung der UTM Generierung entsprechen LOC LISTENER PORT loc_port Nur wenn kein TNSX verwendet wird dann aber Pflichtparameter TCP Portnummer der Stellvertreter AE mit dem G ltigkeitsbereich 102 1025 65535 LOC LU ALIAS loc_lu_alias_name Maximal achtstelliger LU Alias Name der Stellvertreter LU Er muss einem LU Na men in der Konfiguration der LU6 2 Basis Software entsprechen TRANSIT SERVER SNAP IX bzw IBM Communications Server Dieser Name muss nur zwischen openUTM LU62 und der LU6 2 Basis Software abgestimmt sein LOC TSEL T A E loc_tsel Nur wenn kein TNSX verwendet wird dann aber Pflichtparameter Transport Selektor der Stellvertreter AE Das erste Zeichen gibt das Format an T TRANSDATA Zugelassen sind nur Gro buchstaben Ziffern und die Sonderzeichen und wobei das erste Zeichen keine Ziffer sein darf A ASCII E EBCDIC F r alle Formate betr gt die maximale L nge des Inhalts 1oc_tse1 8 Zeichen U5461 J Z135 6 47 openUTM
239. en entstehen k nnen Dies sollte von den Verwaltern der betei ligten Datenbanken gepr ft werden U5461 J Z135 6 307 Meldungen des Programms u62_tp Meldungen von openUTM LU62 422 423 Protokollfehler des LU6 2 Partners amp EVENT im Zustand amp STATE1 amp STATE2 erhalten TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Transaktion wird abgebrochen Der LU6 2 Partner hat gegen das LU6 2 Protokoll verstoBen Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Wenn der Protokollfehler reproduzierbar ist das Ganze mit Trace wiederholen und den Systemdienst verstandigen Protokollfehler des LU6 2 Partners Compare States amp LUWSTATE amp RRI im Zustand amp STATE1 amp STATE2 erhalten TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Der LU6 2 Partner hat wahrend dem Resynchronisieren einer Transaktion gegen das LU6 2 Protokoll verstoBen Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Wenn der Protokollfehler reproduzierbar ist das Ganze mit Trace wiederholen und den Systemdienst verst ndigen M glicherweise m ssen die openUTM LU62 In stanz und der LU6 2 P
240. enSEAS Produktumfeld 22 22 22mm 18 Readme Dateien 2 2 a 19 nderungen gegen ber dem Vorgangerhandbuch 20 Mes 6a ea rk ea a RE ASE PRE OO HSS OSE EEE ESSE 21 Kopplung mit IBM Systemen 2 2 02 un nn 23 Direkte LU6 2 Kopplung ber TRANSIT auf Solaris 22220 25 Direkte LU6 2 Kopplung ber SNAP IX auf Solaris 2 26 Direkte LU6 2 Kopplung ber IBM Communications Server auf Linux oder AIX SYSIEMEN au wa a eG a a a in ih 27 Direkte LU6 2 Kopplung ber IBM Communications Server auf Windows Systemen 2 2 222m nn 28 LU6 2 Kopplung ber Gateway Rechner mit TRANSIT auf Solaris 29 LU6 2 Kopplung ber Gateway Rechner mit SNAP IX auf Solaris 30 LU6 2 Kopplung ber Gateway Rechner mit IBM Communications Server auf Linux oder AlX Systemen 0 2 eee 31 LU6 2 Kopplung ber Gateway Rechner mit IBM Communications Server auf Windows Systemen 2 2 2220 ann 32 Direkte LU6 1 Kopplung mit openUTM ber TRANSIT auf Solaris 33 LU6 1 Kopplung ber Gateway Rechner mit TRANSIT auf Solaris 34 U5461 J Z135 6 Inhalt 3 LU6 2 Kopplungen mit open UTM LU62 222 n nn nenn 35 3 1 Konzepte und Funktionen von openUTM LU62 2 2 22 u une 35 3 1 1 Stelivertretefkonzept co coreane es ech ee ken 35 3 1 2 Architektur von openUTM LU62 7 aa aaa ee 37 3 1 3 Komponenten von openUTM LU62 2 2 nn mn 39 3 1 4 Recovery Funktionen gt
241. enn eine ung ltige APDU empfangen wurde Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPAPDU Typ der APDU amp XP3INFO Zusatzinformation zum Fehler U5461 J Z135 6 331 Meldungen des XAP TP Providers Meldungen von openUTM LU62 P020 OTRACE implizit ausgeschaltet Grund amp XPTRFAIL P021 P100 Diese Meldung wird ausgegeben wenn der Versuch einen Trace Record zu schrei ben fehlgeschlagen ist Als Folge des Fehlers wurde der OSS Trace implizit aus geschaltet Nachdem der Fehler behoben worden ist kann ber die Administration der OSS Trace wieder eingeschaltet werden Die Inserts haben folgende Bedeutung XPTRFAIL Bedeutung 1 Die OSS Funktion o_wutr lieferte den Returncode O_ERROR In der vorangegangenen P001 Meldung finden Sie nahere Informationen zu dem Fehler 2 Die OSS Funktion o_wutr lieferte den Returncode O_INVEREF 3 Die OSS Funktion o_wutr lieferte einen unbekannten Returncode Unerwartetes Event amp XPEVT fuer Association aufgetreten Event wird ignoriert amp ACPNT amp OSLPAP amp XPOSAS amp XPASST Diese Meldung wird ausgegeben wenn ein Ereignis auftritt das nicht zum momen tanen Zustand der Association passt XAP TP ber cksichtigt dieses Ereignis nicht Die Inserts der Meldung haben folgende Bedeutung amp XPEVT Typ des aufgetretenen Ereignisses amp
242. ent Die Funktion PutElement lieferte den Returncode DM_NOMEM Ma nahme In der KDCDEF Generierung den Wert f r die Gr e der OSI Scratch Area erh hen Parameter MAX OSI SCRATCH AREA EVGEOO M Modul KCOXFEV Funktion GetOssEvent Der Returncode des Makros mGetBufferSpace war ungleich LB_OK FREEO1 Modul KCOXFFO Funktion ap_free bis XA Es sind mehr als APFREE_MAX_TO_REL Speicherbereiche freizu FREEO3 geben GSYS00 S Modul KCOCOHF Funktion GetSystemInfo Die UNIX C Funktion uname lieferte einen negativen Returncode LBBDOO AX Modul KCOCOLB Funktion BufferDumpinfo Der Parameter lt nPartEntries gt enthielt einen Wert kleiner oder gleich Null MACFO2 Der Returncode von mGetBufferSpace war ungleich LB_OK MACFO3 M Der Returncode von SetTimer war ungleich TI_OK MACFO4 M Der Returncode von GetLogRecord war ungleich MACF_OK MFCRO7 bis MFCR12 Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK MFCR16 M bis MFCR21 MFCR24 MFDMO3 bis M Der Returncode von PutElement war ungleich DM_OK MFDMO6 MFRMO05 Beim TP_RECOVER_REQ ist kein freier Dialogtabelleneintrag f r ei bis A nen Transaktionszweig vorhanden M gliche Ursache die Anzahl der MFRMO7 Associations im vorherigen Anwendungslauf war gr er als die Anzahl Associations im aktuellen Anwendungslauf MFRMO8 M Der Returncode vom Makro mGetBufferSpace war ungleich LB_OK
243. ent LU Dialog Dialogue In der OSI Begriffswelt eine bestehende Kommunikationsbeziehung zwischen 2 Vorg ngen Ein Dialog beginnt mit einem TP BEGIN DIALOGUE entspricht APRO bei openUTM und endet mit einem TP END DIALOGUE oder TP ABORT Ein Dialog belegt ber seine gesamte Lebensdauer eine Assoziation und sperrt sie damit f r andere Benutzer In der SNA Begriffswelt wird statt dessen der Begriff Conversation verwendet In den openUTM Handb chern wird das Wort Dialog oft auch in anderen Zusammenh ngen verwendet Deshalb wird in diesem Handbuch im Zweifelsfall der Begriff OSI TP Dialog benutzt Distributed Program Link DPL Variante der Programm Kommunikation die von CICS Programmen genutzt werden kann Die Kommunikation zwischen CICS und openUTM ist nicht m g lich Distributed Transaction Processing DTP Variante der Programm Programm Kommunikation die von CICS Program men genutzt werden kann Distributed Transaction Processing erm glicht die Kommunikation zwischen CICS und openUTM Enterprise Extender Von IBM definiertes Protokoll das es erm glicht beliebige SNA Protokolle in IP Netzen zu transportieren Enterprise Extender wird von IBM unter anderem als Nachfolger von Anynet gesehen Enterprise Extender nutzt kein TCP son dern das verbindungslose Protokoll UDP User Datagram Protokoll Unter anderem folgende Produkte unterst tzen Enterprise Extender IBM Communi cations Server f r AIX Linux und Windows SNAP IX
244. er Association 0 Association nicht verkn pft 1 Association mit Channel verkn pft 2 Association mit Instanz verkn pft amp XPCSRC Verursacher des Abbaus 0 ACSE Service User 1 ACSE Service Provider 2 Presentation Service Provider amp XPNDIA siehe Tabelle auf Seite 341 amp XPIINFO OSS Zusatzinformation amp XP2INFO OSS Zusatzinformation U5461 J Z135 6 323 Meldungen des XAP TP Providers Meldungen von openUTM LU62 amp XPINI siehe folgende Tabelle XPINI Bedeutung 0 Die Association wurde von innen abgebaut 401 O_LOC_TRAN Der Verursacher ist das lokale Transportsystem amp XP1INFO enth lt den CMX Returncode Dieser wird in der Folgemeldung P012 detailliert ausgegeben 402 O_REM_TRAN Der Verursacher ist das ferne Transportsystem amp XP1INFO enth lt den Grund des CMX Events t_disin Die Werte sind in cmx h definiert Nachfolgend einige ausge w hlte Werte von amp XP1INFO 0 T_USER Der Abbau erfolgte durch den Kommunikationspartner u U auch durch einen Benutzerfehler auf der Partnerseite 1 T_RTIMEOUT Wegen Inaktivit t der Verbindung gem Parameter t_timeout wurde die Verbin dung lokal durch CMX abgebaut 2 T_RADMIN Wegen Au erbetriebnahme des CCP durch die Administration wurde die Verbin dung lokal durch CMX abgebaut 3 R_CCPEND Wegen CCP Ausfall wurde die Verbindung lokal durch CMX abgebaut 256 T_RUNKOWN Der Partner oder das CCP hat die Verbindung ab
245. er Aufruf eines IMS Kommandos von openUTM z B DISPLAY APPC IMS Command UTM Anwendung APRO AM KCOF B DISPLAY KCRN A FPUT NE APPC KCRN A PEND FI lt FMH5 Daten CEB Quittung gt DISPLAY APPC Ausgabe FMH5 Daten CEB gt lt Quittung TAC DFSCMD FGET PEND FI F r diese Art der Kommunikation muss eine openUTM LU62 Instanz verwendet wer den die mit dem Parameter UTM ASYNC YES generiert ist Bemerkung Der TAC DFSCMD muss in der UTM Anwendung als ASYNTAC generiert sein Der Name DFSCMD ist nicht frei w hlbar sondern wird von IMS vorgegeben Synchroner Aufruf des IMS Message Switch von openUTM DFSAPPC UTM Anwendung APRO DM KCOF B DFSAPPC KCRN A MPUT NE KCRN A PEND KP lt FMH5 Daten Aufruf Message Switch CEB gt MGET NT VGST C KCRN A Bemerkung Der IMS Message Switch erlaubt das Senden von asynchronen Nachrich ten an beliebige LU6 2 Partner der IMS Anwendung Beispielsweise wird mit der Nach richt DFSAPPC TPN REPORT LU FRED REP 1 IMS veranlasst die Nachricht REP1 an den TP Namen REPORT der Partner LU FRED zu senden U5461 J Z135 6 205 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 5 2 8 Ablauf Beispiele mit IMS als Auftraggeber 1 Aufruf eines UTM Asynchron TACS von IMS ohne Transaktionssicherung IMS Anwendung UTM Anwendung GU IOPCB CHNG ALTPCB ISRT ALTPCB PURG ALTPCB FMH5 Daten CEB
246. er CICS Transmission Header TH Protokoll Header der SNA Schicht 3 openUTM verwendet das FID1 Format Hierbei ist der Transmission Header 10 Bytes lang Zwischen TRANSIT und dem IBM Partnersystem wird das FID2 Format f r den Transmission Header verwendet Dabei ist der Transmission Header 6 Bytes lang Typ 2 0 Knoten Bezeichnung f r einen Knoten im SNA Netz der nur Sessions zu seinem berge ordneten Typ 4 oder Typ 5 Knoten aufbauen kann Eine LU in einem Typ 2 0 Knoten ist immer eine dependent LU Typ 2 1 Knoten Bezeichnung f r einen Knoten im SNA Netz der einerseits die Funktionen eines Typ 2 0 Knoten enth lt andererseits aber auch Sessions zu anderen Typ 2 1 Knoten betreiben kann Auf den Sessions zu anderen Typ 2 1 Knoten k nnen nur independent LUs und das Protokoll LU6 2 benutzt werden Das Pro dukt TRANSIT SERVER emuliert einen Typ 2 1 Knoten Typ 4 Knoten Bezeichnung f r einen Knoten der Routingfunktionen im herk mmlichen SNA Netz bernimmt Er unterh lt Verbindungen zu einem oder mehreren Typ 5 Knoten und einem oder mehreren 7yp 2 0 2 1 Knoten Typ 5 Knoten Bezeichnung f r einen Knoten im SNA Netz der Host Funktionen bernimmt d h einen SSCP enth lt Ein Typ 5 Knoten kann gleichzeitig auch die Funk tionen eines Typ 2 1 Knotens abdecken Das fr here Produkt TRANSIT CD emu liert einen Typ 4 und Typ 5 Knoten 370 U5461 J Z135 6 Fachw rter UDP User Datagram Protokoll UDP ist ein Transpo
247. er auf die Kopplung mit CICS und IMS ein Die Kapitel 6 bis 8 beschreiben die LU6 1 Kopplung zwischen openUTM und CICS bzw IMS Dabei beschreibt Kapitel 6 die Kopplung zu CICS Kapitel 7 die LU6 1 Kopplung zu IMS In Kapitel 8 werden spezielle Erweiterungen an der openUTM Programmschnittstelle f r die Kopplung open UTM IMS beschrieben In Kapitel 9 erhalten Sie Hinweise f r eine Fehlerdiagnose im Kapitel 10 werden alle Mel dungen von openUTM LU62 aufgelistet Die ausf hrlichen Verzeichnisse am Ende des Handbuches Fachw rter Abk rzungen Literatur Stichw rter sollen Ihnen den Umgang mit diesem Handbuch erleichtern U5461 J Z135 6 13 Wegweiser durch die Dokumentation zu openUTM Einleitung 1 2 Wegweiser durch die Dokumentation zu openUTM 1 2 1 In diesem Abschnitt erhalten Sie einen berblick ber die Handb cher zu openUTM und zum Produktumfeld von openUTM 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 Internet verf gbar unter der Adresse http manuals ts fujitsu com Die meisten Handb cher k nnen au er
248. er sollte er mit dem dort beim Mode Namen definierten Wert f r die maximale RU Size bereinstimmen Dabei ist zu beachten dass die RU Size in VTAM und TRANSIT SERVER in anderer Form angegeben werden muss Der Wert 4096 ist bei TRANSIT als 89 zu schreiben Weitere Details finden Sie im TRANSIT Handbuch AUTOCONNECT NO I YES ALL Bei Angabe von YES oder ALL werden die Sessions beim Start von CICS aufge baut Bei NO unterbleibt dies INSERVICE YES Die Connection ist verf gbar BUILDCHAIN YES Der Parameter muss immer auf den Standardwert YES gesetzt werden IOAREALEN data_length Mit value wird die Mindestgr e der Terminal Input Output Area von CICS festge legt Dieser Wert sollte mindestens so gro gew hlt werden wie die maximale Nachrichtenl nge der Anwendungsprogramme U5461 J Z135 6 79 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 4 1 2 VTAM Generierung In den F llen bei denen die LUs in VTAM definiert werden m ssen die von openUTM LU62 verwendeten Stellvertreter LUs als independent LUs also mit LOCADDR 0 gene riert sein Au erdem muss der Mode Name in VTAM generiert werden Siehe weiter unten das vollst ndige Generierungsbeispiel TRANSIT Generierung f r openUTM CICS Sessions Bei Verwendung von TRANSIT SERVER muss in TRANSIT zum einen die SNA Verbindung zwischen dem UNIX System und dem SNA Host konfiguriert werden Zum anderen muss dort auch die LU6 2 Verbindung zwischen C
249. erden soll oder kann Das Betriebssystem dieses Rechners ist beliebig Es kann z B ein BS2000 OSD ein Solaris oder Linux System ein Windows System oder ein anderes UNIX System sein Als Gateway Rechner wird ein Solaris System ben tigt UNIX System BS2000 OSD oder Windows System IBM Rechner CICS oder IMS openUTM oder TXSeries CMX PCMX bzw BCAM SNA Basis Software z B VTAM Solaris Rechner CMX openUTM LU62 TRANSIT CPIC TRANSIT SERVER SNA ber Ethernet LU6 2 ber Gateway Rechner mit TRANSIT auf Solaris Im Falle von openUTM unter BS2000 OSD ist zus tzlich das Produkt OSS BS2000 OSD erforderlich Die Verbindung zwischen den beiden linken Rechnern erfolgt ber TCP IP mit RFC1006 Der untere Solaris Rechner muss als PU vom Typ 2 1 im SNA Netz generiert sein Im Bild ist eine SNA Kopplung ber Ethernet dargestellt Zu anderen Kopplungsm glichkei ten siehe das Handbuch TRANSIT SERVER U5461 J Z135 6 29 LU6 2 Kopplung ber Gateway mit SNAP IX auf Solaris Kopplung mit IBM Systemen 2 6 LU6 2 Kopplung ber Gateway Rechner mit SNAP IX auf Solaris Die folgende Kopplungsm glichkeit ber LU6 2 kann immer dann eingesetzt werden wenn der Rechner auf dem die UTM Anwendung l uft nicht direkt an das SNA Netz angebun den werden soll oder kann Das Betriebssystem dieses Rechners ist beliebig Es kann z B ein BS2000 OSD ein Solaris oder Linu
250. ere UTM Transaktionen gleichzeitig mit derselben User Id auf gerufen so muss in der UTM Generierung in der USER Anweisung der Wert RESTART NO angegeben werden Au erdem muss die UTM Anwendung so generiert sein dass Benutzer zu einer Zeit mehrfach unter derselben Benutzerkennung angemeldet sein k nnen Generierungsan weisung SIGNON Pararameter MULTI SIGNON YES 4 1 11 Vollst ndiges Generierungsbeispiel Im Folgenden wird ein komplettes Beispiel einer Kopplung von einer UTM Anwendung auf einem UNIX System mit CICS ESA aufgelistet Die Verbindung zwischen CICS und dem UNIX System ist hierbei mit SNA ber Ethernet realisiert Generierungsparameter die bereinstimmen m ssen sind am rechten Rand mit Zahlen 1 bis 43 markiert Diese Pa rameter sind am Ende des Abschnitts noch genauer erkl rt Das Beispiel enth lt beide Richtungen der Kommunikation den Aufruf eines CICS Pro gramms durch openUTM und umgekehrt CICS Programm Adressierung im Auftraggeber Programm EXEC CICS ALLOCATE SYSID IDI4 1 EXEC CICS CONNECT PROCESS CONVID id PROCNAME UCS1 2 PROCLENGTH 4 SYNCLEVEL 2 w U5461 J Z135 6 83 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 CICS Definitionen System Initialization DFHSIT APPLID A9CICST6 CEDA Definitionen CEDA View Connection IDI4 Connection IDI4 Group KNAS1IIND DEscription CONNECTION IDENTIFIERS Netname TO2CGEIA INDsys
251. ereich 102 1025 65535 REM LU ALIAS rem_lu_alias_name Maximal achtstelliger LU Alias Name f r die Remote LU unter dem die LU6 2 An wendung also z B die CICS Region erreichbar ist Er muss einem RLU Namen in der Konfiguration der LU6 2 Basis Software entsprechen TRANSIT SERVER SNAP IX bzw IBM Communications Server Dieser Name muss nur zwischen openUTM LU62 und der LU6 2 Basis Software abgestimmt sein REM NSEL rem_host Nur wenn kein TNSX verwendet wird DNS Name des Hosts auf dem die Partner UTM Anwendung l uft Der Host Name darf keinen Punkt Domanennamen enthalten und nicht langer als 16 Zeichen sein Liegt der Partnerrechner in einer anderen Dom ne so muss z B auf UNIX in der Datei etc resolv conf der Parameter search um den relevanten Dom nenna men erweitert werden REM TSEL TIAIE rem_tsel Nur wenn kein TNSX verwendet wird dann aber Pflichtparameter Transport Selektor der Partner UTM Anwendung Das erste Zeichen gibt das Format an T TRANSDATA Zugelassen sind nur Gro buchstaben Ziffern und die Sonderzeichen und zugelassen wobei das erste Zeichen keine Ziffer sein darf A ASCII E EBCDIC F r alle Formate betr gt die maximale L nge des Inhalts rem_tsel 8 Zeichen 50 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren UTM ASYNC Dieser Parameter bestimmt wie ein von einem UTM Anwendungsprogramm ge starteter Vorgang ohne Functional Unit Com
252. erfl che bietet Au erdem wird dargestellt wie man WinAdmin konfiguriert um UTM Anwendungen administrieren und gene rieren zu k nnen Testen und Fehler diagnostizieren F r die 0 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 16 U5461 J Z135 6 Einleitung Wegweiser durch die Dokumentation zu openUTM 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 Das 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 oder ActiveX 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 K
253. errno amp ERRNO aufgetreten amp ERRTXT Bei der Verarbeitung des RECEIVE_ALLOCATE Aufrufs durch die LU6 2 Basis Software z B durch TRANSIT ist irgendein Systemaufruf fehlgeschlagen Die eigentliche Fehlerursache in der Variablen errno sollte von der LU6 2 Basis Soft ware beim RECEIVE_ALLOCATE Aufruf geliefert werden Der Wert von errno amp ERRNO samt einer kurzen Interpretation in amp ERRTXT wird von openUTM LU62 daher mit ausgegeben Da jedoch TRANSIT als LU6 2 Basis Software keinen Text liefert erscheint als erkl render Fehlertext stets no interpretation of errno with TRANSIT as LU6 2 software U5461 J Z135 6 285 Meldungen des Programms u62_tp Meldungen von openUTM LU62 312 313 314 315 Aufbau einer Conversation zum LU6 2 Partner zurueckgewiesen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Konfigurationsfehler Der lokale LU Alias Name amp ALIASNAME ist nicht konfiguriert Die LU6 2 Basis Software z B TRANSIT hat den Versuch eine Conversation zum LU6 2 Partner aufzubauen abgelehnt weil der in openUTM LU62 generierte Alias Name amp ALIASNAME der lokalen LU nicht auch in der LU6 2 Basis Software konfi guriert ist Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber LU6 2 Basis Software laeuft nicht Die LU6 2 Basis Software l uft nicht Im Falle von TRANSIT ist also das TRANSIT Grundsystem oder der LU62Mgr nicht gestart
254. esendet werden KCLM bei MPUT FPUT DPUT an einen LU6 2 Partner darf also maximal den Wert 32763 annehmen Wird beim APRO KCSECTYP P angegeben d h will das UTM Anwendungspro gramm dem Partner eine Benutzerkennung senden so muss auch ein Passwort ange geben werden d h KCPWDLTH muss gr er als 0 sein Benutzerkennung und Pass wort d rfen jeweils maximal 10 byte lang sein Wenn openUTM LU62 eine von einem UTM Anwendungsprogramm gew nschte Ver bindung zu einem CICS Transaktionscode nicht aufbauen kann so erh lt die UTM An wendung keine detaillierten Ablehnungsgr nde Die Information in der SYSLOG Datei von openUTM reicht also meist nicht zur Diagnose aus Detaillierte Ablehnungsgr nde sind nur in der Protokolldatei von openUTM LU62 zu finden openUTM bietet die M glichkeit bei der LTAC Generierung eine maximale Wartezeit f r das Belegen einer Session zum Partner zeit1 und eine maximale Wartezeit f r das Eintreffen einer Antwort vom Auftragnehmer zeit2 zu generieren Standardm ig ist zeit1 auf 30 Sekunden zeit2 auf unendlich gestellt Bei einer openUTM CICS Kopplung wird mit zeit1 nur die Wartezeit f r die Belegung einer Verbindung zwischen openUTM und openUTM LU62 berwacht Ist kein Verbindungsaufbau von open UTM LU62 zu CICS m glich so muss die Wartezeit auf das Belegen dieser Verbindung entweder in openUTM LU62 mittels ALLOC TIME oder ber zeit2 begrenzt werden 150 U5461 J Z135 6 openUTM CICS Kopplung
255. esendeter Nachrichten mit einem Sicherungsrequest impliziter Syncpoint f r protected resources an den Partner und die anschlie ende Freigabe der Session Das Kommando hat folgende Syntax EXEC CICS RETURN U5461 J Z135 6 229 Vergleich mit KDCS Aufrufen openUTM CICS Kopplung ber LU6 1 6 7 Vergleich mit KDCS Aufrufen Im folgenden soll versucht werden die CICS Kommandos in ihrer Semantik mit KDCS Auf rufen zu vergleichen Adressierung eines fernen Dialogvorgangs ALLOCATE APRO DM BUILD ATTACH Nachrichtenaustausch ohne Sicherungspunkt SEND MPUT RECEIVE PEND KP INIT MGET Nachrichtenaustausch und Anforderung Transaktionsende SEND MPUT SYNCPOINT PEND RE RECEIVE INIT MGET Nachrichtenaustausch und Anforderung Transaktions und Vorgangsende SEND MPUT RETURN PEND FI Best tigung des Transaktionsendes nach Nachrichtenempfang INIT RECEIVE EIBSYNC X FF MGET KCTAST P SEND MPUT SYNCPOINT RETURN PEND RE FI Wenn vom Vorganger das Transaktionsende ein Sicherungspunkt angefordert wird setzt CICS EIBSYNC X FF und openUTM den Transaktionsstatus KCTAST P Nach Empfang dieser Werte muss ein Befehl zum Schreiben eines Sicherungspunktes abgesetzt werden SYNCPOINT RETURN bzw PEND RE FI 230 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 Programmbeispiele f r CICS openUTM Kommunikation 6 8 Programmbeispiele f r CICS openUTM Kommunikation 1 Start eines UT
256. estartet ist Alle OSI TP Dialoge zum OSI TP Partner zur UTM Anwendung wer den daher im Moment zur ckgewiesen Aktiver Aufbau einer Conversation zum Resync TP X 06F2 wegen Konfigurationsfehlers zurueckgewiesen Der lokale LU Alias Name amp ALIASNAME ist nicht konfiguriert Diese Meldung wird ausgegeben wenn der erste Aufruf zum Start des lokalen Resync TP schiefgeht weil der angegebene lokale LU Alias Name amp ALIASNAME nicht in der LU6 2 Basis Software konfiguriert ist Die MaBnahmen in diesem Fall sind bei der Meldung 521 beschrieben Aktiver Aufbau einer Conversation zum Resync TP X 06F2 fehlgeschlagen Systemfehler errno amp ERRNO aufgetreten amp ERRTXT Bei dem Versuch eine Conversation zum LU6 2 Partner aufzubauen ist in der LU6 2 Basis Software z B TRANSIT irgendein Systemaufruf schiefgegangen Wie bei den Meldungen 311 und 314 beschrieben stellt TRANSIT keinen Fehler text zur Verf gung als amp ERRTXT erscheint dann also immer no interpretation of errno with TRANSIT as LU6 2 software Dieser tempor re Fehler f hrt nur zum Abweisen aller OSI TP Dialoge mit Func tional Unit Commit zum OSI TP Partner d h zur UTM Anwendung die auf das Ende des Austausches der Log Namen warten Ein misslungener Compare States f r eine bestimmte LUW wird nach einer gewissen Wartezeit wiederholt Basic Conversation fuer TP amp TPNAME abgelehnt Das einzig moegliche TP das basic Conversations unterstuetzt
257. et Damit ist keine Kommunikation ber LU6 2 m glich amp TPNAME bezeichnet z B den CICS Transaktionscode Aufbau einer Conversation zum LU6 2 Partner fehlgeschlagen TP Name amp TPNAME OSI TP Seite ist Auftraggeber Systemfehler errno amp ERRNO aufgetreten amp ERRTXT Bei dem Versuch eine Conversation zum LU6 2 Partner aufzubauen ist in der LU6 2 Basis Software z B in TRANSIT irgendein Systemaufruf schiefgegangen Ahnlich wie beim RECEIVE_ALLOCATE Aufruf siehe Meldung 311 stellt TRANSIT keinen Fehlertext zur Verf gung so dass als amp ERRTXT immer folgender Text ausgegeben wird no interpretation of errno with TRANSIT as LU6 2 software Bereits aufgebaute Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber wegen Konfigurationsfehler wieder abgebaut Der Netzname der lokalen und oder der fernen LU ist umkonfiguriert worden Eine bereits aktiv aufgebaute Conversation zum TP amp TPNAME des LU6 2 Partners wird unmittelbar danach wieder abgebaut weil bei der berpr fung der Netzwerk namen der lokalen und der fernen LU eine Inkonsistenz festgestellt wurde Dies be deutet dass sich hinter den Alias Namen der lokalen und oder der fernen LU z B in der TRANSIT Konfigurierung nicht mehr dieselben LUs im SNA Netz verber gen wie zu einem fr heren Zeitpunkt Dieser Meldung geht stets mindestens eine der Meldungen 042 und 044 voraus 286 U5461 J Z135 6 Meldungen von open UTM
258. f hrt zum Vorgangsstatus Z im UTM Anwendungsprogramm nach dem Wiederanlauf Konvertierung von Benutzerdaten Bei einer Kopplung zwischen open UTM unter UNIX oder Windows Systemen und CICS m ssen Benutzerdaten von ASCII nach EBCDIC und umgekehrt konvertiert wer den Wenn die Benutzerdaten nur aus abdruckbaren Zeichen bestehen kann man dies durch Verwendung des Parameters MAP SYSTEM in der SESCHA Anweisung von openUTM erreichen Man beachte jedoch dass dies eine Konvertierung von BS2000 EBCDIC nach ASCII und umgekehrt bewirkt Auf IBM Systemen wird jedoch meist ein anderes EBCDIC verwendet Somit werden Umlaute und einige Sonderzeichen falsch umgesetzt Es empfiehlt sich deshalb die ASCII EBCDIC Konvertierung im UTM oder CICS Anwendungsprogramm durchzuf hren Aus den genannten Gr nden sollte auch bei einer Kopplung zwischen UTM unter BS2000 OSD und CICS eine Konvertierung im Anwendungsprogramm vorgenommen werden 234 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 Hinweise zur openUTM CICS Programmierung Vereinbarungen bei der open UTM CICS Programmierung Zwischen den Partnern openUTM und CICS m ssen f r die Programmierung folgende Punkte vereinbart werden Namen der Transaktionen Datenformat Satzformat VLVB oder Chain of RUs synchron LU6 1 asynchron Kommandofolge Werte im FMH6 asynchron U5461 J Z135 6 235 236 U5461 J Z135 6 7 openUTM IMS Kopplung ber LU6 1
259. fort wieder mit einer bei beiden obigen Fehlermeldungen Id des Basis Thread amp ID Id des Service Thread amp ID Beim Start als Service werden nur zur Information die Thread Id s des Basis und des eigentlichen Service Threads in die Datei stdout txt ausgegeben U5461 J Z135 6 345 Meldungen von u62_start Meldungen von openUTM LU62 26 27 28 29 30 31 32 33 34 35 Service Control Dispatcher erfolgreich zurueckgekehrt Diese Meldung wird mit einem Zeitstempel versehen nach erfolgreicher R ck kehr des Service Dispatcher d h der Systemfunktion die den eigentlichen Dienst startet in die Datei stdout txt ausgegeben Service Control Dispatcher fehlgeschlagen Fehlercode amp ERRNO amp ERRTEXT Diese Meldung wird mit einem Zeitstempel versehen nach einer fehlerhaften R ckkehr des Service Dispatchers d h der Systemfunktion die den eigentlichen Dienst startet in die Datei stderr txt ausgegeben Warten auf das Ende des Service Thread Nach dem Beenden von open UTM LU62 als Dienst muss noch abgewartet werden bis sich der Service Thread beednet hat bevor man das Programm verl sst Um zu verdeutlichen wie lange dieser Vorgang dauert wird die Meldung 28 alle 100 Milli sekunden wiederholt Service Thread hat sich beendet Diese Meldung versehen mit einem Zeitstempel zeigt an wann sich der Service Thread endg ltig beendet hat Fehler beim Installieren des Service
260. ftraggeber Kom mandos SEND RECEIVE CONVERSE die sich auf diese Session beziehen an gegeben werden PROFILE name spezifiziert ein bestimmtes Profil f r die Kommunikation mit dem Partner PROFILEs werden mittels CICS Definitionen siehe CICS for MVS ESA Resource Definition festgelegt NOQUEUE bedeutet dass nicht gewartet werden soll falls nicht sofort eine Session verf gbar ist Eine Session ist nicht sofort verf gbar wenn entweder 1 alle Sessions zu der fernen UTM Anwendung belegt sind oder 2 vorhandene Sessions noch nicht aktiv gebunden sind oder 3 die noch verf gbaren Sessions alle contention loser sessions RECEIVECOUNT 1 sind Wird NOQUEUE nicht verwendet so h ngt CICS den Request in eine Warteschlan ge ein und das Programm wartet bis eine Session verf gbar ist Bei openUTM unter UNIX Systemen darf NOQUEUE nicht verwendet werden da CICS immer contention loser ist und somit keine Session sofort zur Verf gung steht 220 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r CICS Auftraggeber Vorg nge BUILD ATTACH Mit diesem Kommando wird vom CICS Auftraggeber Vorgang ein ATTACH Header FMH5 erstellt in den der TAC f r den fernen UTM Vorgang einzutragen ist Dieser FMH ist f r In itiierung von UTM Vorg ngen notwendig und wird mit SEND oder CONVERSE an den Partner gesendet Das Kommando hat folgende Syntax EXEC CICS BUILD ATTACH ATTACHID name PROCESS name
261. gebaut Ein Grund f r den Abbau wurde nicht angegeben 257 T_RSAP_CONGEST Wegen eines TSAP spezifischen Engpasses hat das Partner CCP die Verbindung abgebaut 258 T_RSAP_NOTATT Das Partner CCP hat die Verbindung abgebaut weil der adressierte TSAP dort nicht angemeldet ist 259 T_RUNSAP Das Partner CCP hat die Verbindung abgebaut weil der adressierte TSAP dort nicht bekannt ist 261 T_RPERMLOST Abbau durch die Netzadministration oder Administration des Partner CCP 262 T_RSYSERR Fehler im Netz 385 T_RCONGEST Das Partner CCP hat die Verbindung wegen Betriebsmittelengpass abgebaut 324 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers XPINI Bedeutung 386 T_RCONNFAIL Das Partner CCP hat die Verbindung wegen Misslingen des Verbindungsaufbaus abgebaut 387 T_RDUPREF Weil f r ein NSAP Paar eine zweite Verbindungsreferenz vergeben wurde Systemfehler wurde die Verbindung vom Partner CCP abgebaut 388 T_RMISREF Das Partner CCP hat die Verbindung wegen einer nicht zuzuordnenden Verbin dungsreferenz Systemfehler abgebaut 389 T_PROTERR Das Partner CCP hat die Verbindung wegen eines Protokollfehlers Systemfehler abgebaut 391 T_PREFOFLOW Das Partner CCP hat die Verbindung wegen Verbindungsreferenz Uberlauf abgebaut 392 T_RNOCONN Das Partner CCP hat den Aufbau der Netzverbindung abgelehnt 394 T_RINLNG Das Partner CCP hat di
262. gesendet Ruft das CICS Auftragnehmerprogramm ISSUE ERROR auf wenn es vom UTM Anwen dungsprogramm zum Einleiten des Transaktionsendes aufgefordert wird so f hrt dies zu einem R cksetzen der Transaktion Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim ISSUE ERROR zum UTM Auftraggeber Vorgang CONVID nicht angegeben werden U5461 J Z135 6 117 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 SYNCPOINT Mit dem Kommando wird auf Anforderung des Auftraggebers das Transaktionsende einge leitet Wichtig ist bei einer Kopplung zu openUTM dass ein CICS Programm SYNCPOINT nur dann verwenden darf wenn das UTM Anwendungsprogramm es vorher zum Einleiten des Transaktionsendes aufgefordert hat Das CICS Programm kann am Parameter STATE oder im Feld EIBSYNC eines jeden CICS Kommandos erkennen ob es zur Einleitung des Transaktionsendes aufgefordert wurde STATE muss dann einen der Werte SYNCFREE SYNCRECEIVE oder SYNCSEND annehmen EIBSYNC muss den Wert X FF annehmen Die Syntax ist gleich wie bei Auftraggeber Vorg ngen SYNCPOINT ROLLBACK Mit diesem Kommando wird die Transaktion zur ckgesetzt Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen FREE Das Kommando gibt die Session zum Auftraggeber Vorgang wieder frei Syntax und Bedeutung sind gleich wie bei Auftraggeber Vorg ngen Allerdings muss beim Auftraggeber Vorgang CONVID nicht angegeben wer
263. gsfehler entweder nur CICS oder nur die open UTM LU62 Instanz mit Kaltstart hochgefahren und das andere System mit Warmstart gestartet wird so wird dies beim Verbindungsaufbau zwischen openUTM LU62 und CICS bemerkt In die sem Fall gibt openUTM LU62 eine Meldung aus und bricht den Verbindungsaufbau zu CICS ab Auf CICS Seite kann man diesen Zustand mittels CEMT INQUIRE CONNEC TION abfragen Anzeige Xno Wenn eine openUTM LU62 Instanz warm gestartet wurde und Recovery Informationen verf gbar sind CICS dagegen wegen Kaltstart oder CEMT SET CONNECTION NOTPENDING keine Recovery Informationen mehr hat so m ssen Sie die entsprechen de openUTM LU62 Instanz kalt starten Wenn die openUTM LU62 Instanz kalt gestartet wurde und CICS den Aufbau von transaktionsgesicherten Verbindungen wegen Exchange Log Name Fehler ablehnt m ssen Sie in CICS das Kommando CEMT SET CONNEC TION NOTPENDING ausf hren Die Kalt Warmstart Koordination zwischen openUTM LU62 und der UTM Anwendung kann von openUTM LU62 nicht berpr ft werden da es im OSI TP Protokoll keine Metho den hierf r gibt Zwischen openUTM LU62 und der UTM Anwendung muss genauso sorg f ltig Kalt und Warmstart abgesprochen werden 3 1 5 Einschr nkungen bei der Protokollabbildung openUTM LU62 bildet die Protokolle LU6 2 und OSI TP aufeinander ab Da die beiden Pro tokolle in ihrem Funktionsumfang nicht genau identisch sind kann openUTM LU62 nur die gemeinsame Schni
264. gt lt Quittung INIT FGET PEND FI 2 Aufruf eines UTM Dialog TACS von IMS mit Transaktionssicherung IMS Anwendung UTM Anwendung Allocate synclev 2 Send_Data Prep_To_Rcv FMHS5 Daten gt INIT MGET VGST O MPUT NE PEND KP lt Daten Receive DATA Deallocate SRRCMIT Prepare gt INIT MGET TAST P PEND FI 206 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren IMS Anwendung UTM Anwendung lt Req Commit Committed gt lt Forget CEB Transaktionsgesicherte Kommunikation mit IMS als Auftraggeber ist nur m glich wenn die IMS Anwendungsprogramme die Programmschnittstelle CPI C verwenden U5461 J Z135 6 207 IMS Administration openUTM IMS Kopplung ber LU6 2 5 3 IMS Administration Administrationskommandos werden im wesentlichen f r folgende Aufgaben ben tigt e Anzeige der Verbindungszust nde e Aufbau von LU6 2 Sessions zum Partner e Aufldsen von Exchange Log Name Problemen Zum Anzeigen der Verbindungszust nde gibt es folgende IMS Kommandos DISPLAY APPC LU ALL Anzeige aller LUs DISPLAY APPC TP ALL Anzeige der verwendeten LU6 2 TP Namen DISPLAY APPC CONV Anzeige der laufenden Conversations DISPLAY APPC UOR ALL Anzeige der laufenden 2 Phase Commit Transaktionen Mit dem IMS Kommando ALLOCATE kann man Sessions zu LU6 2 Partnern aufbauen Das LU6 2 Protokoll enthalt beim Sessiona
265. h lt die Beschreibung der Generierungsparameter IBM Communications Server for Linux Quick Beginnings Das Dokument enth lt die Einf hrung in das Produkt und die Installationsanleitung IBM Communications Server for Linux Administration Guide Das Dokument enth lt die Beschreibung der Administration sortiert nach Aufgabenberei chen IBM Communications Server for Linux Administration Command Reference Das Dokument enth lt die Beschreibung der Administrations Kommandos alphabetisch nach dem Namen der Kommandos sortiert Es beschreibt au erdem die Generierungspa rameter IBM Communications Server for Linux Diagnostics Guide Das Dokument enth lt die Beschreibung der Diagnosem glichkeiten IBM Communications Server for AIX Quick Beginnings Das Dokument enth lt die Einf hrung in das Produkt und die Installationsanleitung IBM Communications Server for AIX Administration Guide Das Dokument enthalt die Beschreibung der Administration sortiert nach Aufgabenberei chen IBM Communications Server for AIX Administration Command Reference Das Dokument enthalt die Beschreibung der Administrations Kommandos alphabetisch nach dem Namen der Kommandos sortiert Es beschreibt au erdem dieGenerierungspa rameter IBM Communications Server for AIX Diagnostics Guide Das Dokument enth lt die Beschreibung der Diagnosem glichkeiten U5461 J Z135 6 393 Literatur Sonstige Literatur CPI C X Open Distributed Tran
266. h abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Passwort als Octet String ist unzulaessig Die voranstehenden vier Meldungen zeigen an dass die vom OSI TP Partner d h von der UTM Anwendung empfangene TP_BEGIN_DIALOGUE indication eine unzul ssige Benutzerkennung oder ein unzul ssiges Passwort enth lt Leere Be nutzerkennungen und Passworte werden jedoch von openUTM LU62 ebenso we nig unterst tzt wie Benutzerkennungen bzw Passworte die als Octet String codiert sind da dies nicht ins LU6 2 Protokoll umgesetzt werden kann Zul ssig sind nur Codierungen als PRINTABLE_STRING oder als T61_STRING sowie die Angabe von Already verified statt eines Passwortes Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Fehler beim Austausch der Log Namen zwischen der lokalen und der fernen LU Der OSI TP Partner d h die UTM Anwendung hat einen OSI TP Dialog mit Functional Unit Commit zu openUTM LU62 aufgebaut Bevor jedoch openUTM LU62 eine entsprechende Conversation mit Sync Level 2 zum LU6 2 Partner auf bauen darf m ssen im Fall dass die Anzahl der Sessions inzwischen auf 0 gesun ken war die Log Namen zwischen den beiden LUs erneut ausgetauscht werden weil ja dann der LU6 2 Partner in der Zwischenzeit einen Kaltstart durchgef hrt haben kann Kommt es dann bei diesem Austausch der Log Namen zu einem Feh ler so wird der OSI TP Dialogwunsch des OSI TP Partners d h der UTM Anwen
267. h der Log Namen festge stellt Eine m gliche Ursache ist ein Kaltstart von openUTM LU62 obwohl der LU6 2 Partner noch Transaktionen resynchronisieren muss Falls noch Transaktionen resynchronisiert werden m ssen und die Synclog Datei von openUTM LU62 noch nicht gel scht ist sollten Sie einen Warmstart versu chen da sonst Gefahr von Datenbank Inkonsistenzen besteht Wenn dies nicht m glich ist m ssen Sie entweder die Partner LU kalt starten oder beim LU6 2 Part ner noch bestehende Transaktionen Logical Units of Work abnormal beenden Solange der Fehler noch nicht behoben ist werden von openUTM LU62 keine OSI TP Dialoge mit Functional Unit Commit und keine Conversations mit Sync Level 2 unterst tzt Die LU Alias Name amp ALIASNAME Netzname amp NETNAME hat einen Kaltstart versucht die lokale LU hat jedoch noch LUWs logical units of work von einer frueheren Aktivierung zu resynchronisieren Der LU6 2 Partner hat einen Kaltstart durchgef hrt obwohl noch Transaktionen Logical Units of Work zu openUTM LU62 bestehen die noch resynchronisiert werden m ssen Wenn m glich sollte der Kaltstart des LU6 2 Partners r ckg ngig gemacht werden da ansonsten die Gefahr von Datenbankinkonsistenzen besteht Wenn dies nicht m glich ist kann die Situation nur durch Beendigen der openUTM LU62 Instanz und nachfolgenden Kaltstart bereinigt werden 310 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u6
268. hler aufgetreten System Call fork schiefgegangen errno amp ERRNO amp ERRTEXT u62_start benutzt den Systemaufruf fork um im Hintergrund zu verschwinden so dass der Aufruf nicht blockiert Geht dieser Aufruf schief gibt u62_start mit dieser Meldung die Fehlerursache aus In der Regel ist die maximale Anzahl von Prozes sen auf dem System oder f r den Benutzer berschritten was durch nderung der Systemeinstellungen zu beheben ist Auf Windows Systemen wird anstelle von fork der Systemaufruf CreateProcess benutzt System Call fork zum Start der Instanz fuer den lokalen LU Namen amp LUNAME ist schiefgegangen errno amp ERRNO amp ERRTEXT Genau wie bei Meldung 13 beschrieben liegt auch hier ein Mangel an Systemres sourcen vor System Call execv zum Start der Instanz fuer den lokalen LU Namen amp LUNAME ist schiefgegangen errno amp ERRNO amp ERRTEXT Fehler beim Systemaufruf execv Auf Windows Systemen wird anstelle von execv der Systemaufruf CreateProcess benutzt Das Oeffnen der Protokoll Datei amp FILENAME ist schiefgegangen errno amp ERRNO amp ERRTEXT Vermutlich sind Systemressourcen aufgebraucht Dateisystem voll maximale Anzahl von I Nodes erreicht 344 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen von u62_start 17 18 19 20 21 22 23 24 25 openUTM LU62 gestartet lokaler LU Alias Name amp LUNAME PID amp INSTPID Start
269. hlerhaft ausgef hrt Beispielsweise wurde die geforderte Datenbank nderung auf LU6 2 Seite ausgef hrt auf UTM Seite aber nicht Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 blicherweise sind in diesem Fall manuelle Eingriffe in eine der beteiligten Daten banken notwendig um die inkonsistenten Datenbankst nde wieder zu koordinie ren U5461 J Z135 6 305 Meldungen des Programms u62_tp Meldungen von openUTM LU62 409 410 420 OSI TP Partner meldet heuristischen Hazard TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Nach einem Verbindungsverlust zum OSI TP Partner d h zur UTM Anwendung kann nicht mehr mit Sicherheit festgestellt werden ob die offene Transaktion durch gef hrt oder zur ckgesetzt wurde Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Die Verwalter der an der Transaktion beteiligten Datenbanken sollten pr fen ob eine Datenbank Inkonsistenz entstanden ist Syncpoint Request vom LU6 2 Auftragnehmer mit TP Name amp TPNAME erhalten Transaktion wird abgebrochen Ein Auftragnehmerprogramm auf LU6 2 Seite hat einen Syncpoint angefordert z B EXEC CICS SYNCPOINT ohne vom UTM Anwendungsprogramm dazu auf gefordert worden zu sein Dies ist bei openUTM verboten Die Transaktion w
270. hners Fehler beim Erzeugen der PID Datei amp PIDFILE errno amp ERRNO amp ERRTEXT Die Instanz kann eine ihrer intern verwendeten Systemdateien amp PIDFILE nicht anlegen Die Systemvariable errno amp ERRNO gibt Aufschluss ber die Ursache Fehler beim Schreiben in die PID Datei amp PIDFILE errno amp ERRNO amp ERRTEXT Es kann keine Information in der intern verwendeten Datei amp PIDFILE abgelegt wer den Vermutlich ist das Dateisystem voll Fehler beim Schreiben in die PID Datei amp PIDFILE geschrieben amp NUM1 Bytes erwartet amp NUM2 Bytes Der Versuch amp NUM2 Bytes in die Datei amp PIDFILE zu schreiben ist fehlgeschla gen Wahrscheinlich aufgrund eines vollen Dateisystems konnten von den amp NUM2 Bytes nur amp NUMI Bytes abgelegt werden Fehler beim Erzeugen der Input Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT Der Versuch die Named Pipe amp PIPEFILE anzulegen ist fehlgeschlagen Die Feh lerursache ist in der Variable errno enthalten Da die Input Pipe nur einmal und zwar w hrend der Initialisierung angelegt wird kann diese Meldung nur unmittelbar nach dem Start erscheinen Da in diesem Fall keine Kommunikation mit den bri gen Komponenten von openUTM LU62 m glich ist beendet sich die Instanz Fehler beim Oeffnen der Input Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT Die soeben erzeugte Named Pipe amp PIPEFILE kann nicht zum Lesen ge ffnet wer den Ansonsten gilt das Gle
271. hrichtigt werden Die Transaktionssicherung im Beispiel 24 bringt f r die Anwendungsprogramme gegen ber dem Ablauf ohne Transaktionssicherung Beispiel 23 folgende Vorteile Das Absenden der Asynchron Nachricht im UTM Anwendungsprogramm wird automa tisch mit anderen Abl ufen im Anwendungsprogramm z B mit einem Datenbank Up date gekoppelt Wenn der PEND FI erfolgreich ist wird der CICS Asynchron Vorgang garantiert genau einmal gestartet Dieser Fall ist hnlich zu Beispiel 14 Die CICS Programmierung ist bei beiden Beispielen identisch Auf UTM Seite hat der Dialog Fall Beispiel 14 den Vorteil dass die Anwendung ber Erfolg oder Misserfolg des Aufrufs informiert wird Der asynchrone Fall Beispiel 24 eignet sich vor allem f r zeitgesteuerte Auftr ge U5461 J Z135 6 145 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 4 2 6 Distributed Program Link In CICS gibt es die M glichkeit Programme auf verschiedenen Systemen mittels Distribu ted Program Link DPL zu verbinden Mit dieser Technik kann ein CICS Programm auf einem System ein CICS Programm auf einem anderen System als Unterprogramm aufru fen Es verwendet dazu den CICS Aufruf EXEC CICS LINK Distributed Program Link ist zwischen CICS und openUTM nicht m glich In einer mehrstufigen Hierarchie k nnen jedoch auch UTM Anwendungsprogramm eingesetzt werden Die folgenden beiden Bei spiele zeigen eine derartige Kommunikation Dabei z
272. ias durch den aktuellen Wert der entsprechenden open UTM LU62 Instanz ersetzt ist Diese Datei ent spricht also in etwa der KDCFILE einer UTM Anwendung Auf Windows Systemen liegt die Datei sync 10g loc_lu_alias im Dateiverzeichnis Programme utm l u62 wobei loc_lu_alias der Wert des Parameters der IINSTANCE Anweisung ist siehe Abschnitt INSTANCE Anwei sung auf Seite 43 openUTM LU62 bietet auch die M glichkeit eines Kaltstarts Beim Kaltstart werden die vor handenen Log Records gel scht Generell sollte ein Kaltstart nur in Ausnahmef llen ver wendet werden Nach Rechnerabsturz oder abnormaler Beendigung von openUTM LU62 sollte auf jeden Fall ein Warmstart durchgef hrt werden Wird jedoch zwischen dem Rechnerabsturz und dem Warmstart von openUTM LU62 die LU6 2 Anwendung mit Kaltstart neu gestartet so muss auch die entsprechende openUTM LU62 Instanz mit Kaltstart hochgefahren werden In diesem Fall werden die offenen Trans aktionen nicht abgeschlossen Bei CICS kann im laufenden Betrieb f r eine Connection das Kommando CEMT SET CONNECTION NOTPENDING eingegeben werden Dieses Kommando l scht die in CICS gespeicherten Log Records f r die betreffende Verbindung Wenn dieses Kommando f r die Connection zur UTM Anwendung abgesetzt wird hat es hat also dieselben Auswirkun gen wie ein Kaltstart 40 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 Konzepte und Funktionen von openUTM LU62 Wenn durch einen Bedienun
273. ibung gen_file Name der Generierungsdatei aus der die Generierungsparameter gelesen werden sollen Standardwert ist opt 1ib utm1u62 gen genfile UNIX Systeme bzw Programme utmlu62 gen genfile Windows Systeme f conf_file File Name der Konfigurationsdatei in die Generierungsdaten in binarer Form geschrieben werden sollen Ist conf_file nicht angegeben erfolgt die Ausgabe in die Datei opt 1ib utmlu62 conffile UNIX Systeme bzw Programme utmlu62 conffile Windows Systeme Das Programm u62_tp liest wahrend seiner Initialisierung die Konfigurationsdaten aus der Datei conf file Diese Konfigurationsdatei kann auch bei laufendem u62_tp mittels u62_gen neu erzeugt werden Die neuen Konfigurationsdaten werden jedoch erst beim nachsten Start der jeweiligen openUTM LU62 Instanz wirksam u62_gen l scht keine f r das Recovery ben tigten Log Records Zum Thema Recovery sie he auch Abschnitt Recovery Funktionen auf Seite 40 52 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 generieren 3 2 4 3 2 5 Generierungsdatei wiederherstellen Wollen Sie aus einer bin ren Konfigurationsdatei eine lesbare Generierungsdatei erstellen um z B den Generierungslauf zu berpr fen so k nnen Sie das mit folgendem Kommando erreichen Aufrufsyntax opt 1lib utmlu62 u62_gen r Lconf_file Beschreibung r Restore conf_file Name der binaren Konfigurationsdatei Ist conf_file nicht angegeben so wird die Da
274. iche wie oben in Meldung 018 beschrieben 266 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 020 021 022 023 025 Es konnten nur amp NUM1 von den gewuenschten amp NUM2 XAP TP Instanzen erzeugt werden In der Initialisierungsphase wird versucht f r jede gew nschte parallele Verbindung Konfigurationsparameter ASSOCIATIONS und f r die sogenannte XAP TP Kon trollinstanz zur Transaktions berwachung eine XAP TP Instanz anzulegen L sst der XAP TP Provider aber statt der gew nschten amp NUM2 XAP TP Instanzen nur amp NUMI zu so wird diese Meldung ausgegeben Es liegt vermutlich ein Betriebsmittelengpass vor den der Systemverwalter behe ben sollte Neuer Log Name von openUTM LU62 erzeugt amp LOGNAME Wurde als Application Context der Wert UDTCCR oder UDTSEC generiert so m s sen auf LU6 2 Seite Conversations mit Sync Level 2 unterst tzt werden Vorausset zung daf r ist der Austausch der Log Namen mit dem LU6 2 Partner Zur Informa tion des Systemverwalters wird bei einem Kaltstart der Instanz mit dieser Meldung der neu erzeugte Log Name amp LOGNAME von openUTM LU62 ausgegeben Log Name von openUTM LU62 aus Synclog Datei restauriert amp LOGNAME Bei einem Warmstart von openUTM LU62 wird kein neuer Log Name generiert sondern derjenige aus einem fr heren Kaltstart bernommen Diese Meldung erscheint nur w hrend der Initialisierung und dient lediglich der Information
275. icherung m glich ist openUTM LU62 lehnt den OSI TP Dialog wunsch daher ab 296 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 370 371 373 374 Wenn Die Funktionseinheit Commit von openUTM LU62 unterst tzt werden soll muss ein geeigneter mit dem OSI TP Partner abgestimmter Application Context generiert werden APPL CONTEXT UDTSEC Standard oder APPL CONTEXT UDTCCR Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Explizite Bestaetigung mittels DIALOGUE_RSP angefordert Der OSI TP Partner hat beim OSI TP Dialogaufbau eine explizite Bestatigung mit einer TP_BEGIN_DIALOGUE_RSP Primitiven angefordert Da das LU6 2 Proto koll keine direkte Entsprechung daf r hat wird der OSI TP Dialogwunsch von openUTM LU62 abgewiesen Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Keine Unterstuetzung von unchained transactions openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit der Functional Unit Commit_and_unchained empfangen Das LU6 2 Protokoll bietet jedoch keine entsprechende Funktionalit t so dass openUTM LU62 den OSI TP Dialogwunsch ablehnt Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite i
276. ie Literatur der Firma Data Con nection Limited zu SNAP IX und ber die IBM Literatur zu den IBM Communications Ser ver Produkten Die Literaturliste bezieht sich auf die Versionen SNAP IX Version 7 IBM Communications Server for Windows Version 6 1 2 IBM Communications Server for Linux Version 6 2 2 IBM Communications Server for AIX Version 6 3 SNAP IX General Information Das Dokument enth lt allgemeine Informationen zu SNAP IX SNAP IX Installation Das Dokument enth lt die Anleitung zur Installation von SNAP IX auf Solaris Systemen SNAP IX Administration Guide Das Dokument enth lt die Beschreibung der Administration von SNAP IX sortiert nach Aufgabenbereichen SNAP IX Administration Command Reference Das Dokument enth lt die Beschreibung der Administrations Kommandos von SNAP IX alphabetisch nach dem Name der Kommandos sortiert Es beschreibt au erdem die Gene rierungsparameter SNAP IX Diagnostic Guide Das Dokument enth lt die Beschreibung der Diagnosem glichkeiten in SNAP IX IBM Communications Server for Windows Quick Beginnings Das Dokument enth lt die Einf hrung in das Produkt und die Installationsanleitung IBM Communcations Server for Windows Network Administration Guide Das Dokument enth lt die Beschreibung der Administration sortiert nach Aufgabenberei chen 392 U5461 J Z135 6 Literatur IBM Communications Server for Windows Configuration File Refernce Das Dokument ent
277. ie den Auftrag zum Beenden des Service bearbeitet Geht dies schief wird die Fehlermeldung 37 ausgegeben Der Fehlercode ERRNO der Sy stemfunktion FUNKNAME gibt Aufschluss ueber die genaue Fehlerursache openUTM LU62 beendet sich daraufhin Fehler beim Setzen des Service Status Funktion amp FUNKNAME Fehlercode amp ERRNO amp ERRTEXT Der Dienst openUTM LU62 gibt dem System zu unterschiedlichen Zeitpunkten Auskunft dar ber in welchem Zustand sich der Dienst im Moment befindet Geht die entsprechende Systemfunktion amp FUNKNAME schief wird die Meldung 38 aus gegeben openUTM LU62 beendet sich daraufhin Fehler beim Erzeugen eines neuen Thread Fehlercode amp ERRNO amp ERRTEXT Nachdem alle Instanzen von openUTM LU62 erfolgreich gestartet worden sind er zeugt u62_start Threads deren Aufgabe lediglich darin besteht auf das Ende der Instanzen zu warten und danach Aufr umarbeiten durchzuf hren Geht der ent sprechende Funktionsaufruf CreateThread schief wird diese Meldung ausgege ben und openUTM LU62 beendet sich U5461 J Z135 6 347 Meldungen von u62_start Meldungen von openUTM LU62 40 42 43 Aufruf Zum Start der Instanzen von openUTM LU62 u62_start lt LU Name gt c k t on lt Trace Optionen gt LU Name Name der lokalen LU der openUTM LU62 Instanz C Kaltstart von openUTM LU62 k Lauwarmer Start von openUTM LU62 ton Explizite Spezifikation des Trace durch Angabe
278. im EIB Die Transaktion ist dann im Zustand ET end of transaction Das Kommando hat folgende Syntax EXEC CICS SYNCPOINT RETURN Das Kommando RETURN impliziert das Senden noch nicht gesendeter Nachrichten mit einem Sicherungsrequest an den Partner und anschlie ender Sessionfreigabe Das RETURN Kommandb ist nur zul ssig wenn der UTM Auftragnehmer Vorgang bereits PEND FI gegeben hat Indikator EIBFREE im EIB Das Kommando hat folgende Syntax EXEC CICS RETURN 226 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r CICS Auftragnehmer Vorg nge 6 6 CICS Kommandos f r CICS Auftragnehmer Vorg nge RECEIVE Dieses Kommando wird verwendet um eine von einem UTM Auftraggeber Vorgang gesen dete Nachricht zu empfangen Unmittelbar nach der Initialisierung durch einen fernen UTM Vorgang ist ein CICS Vorgang im RECEIVE Zustand und muss die Nachricht mit diesem Kommando einlesen Das Kommando hat folgende Syntax EXEC CICS RECEIVE INTO bereich SET pntr LENGTH bereich LMAXLENGTH bereich CNOTRUNCATE Die Option NOTRUNCATE bewirkt dass der Rest der Nachricht einem folgenden RECEIVE Kommando zur Verf gung gestellt wird falls die Nachricht l nger als MAXLENGTH ist Zu den brigen Optionen siehe Seite 223 EXTRACT ATTACH Dieses Kommando wird verwendet um Informationen aus dem empfangenen ATTACH Header zu lesen Indikator EIBATT im EIB Das Kommando hat folgende Syntax EXEC CICS EXTRA
279. im Kontext ist 34 NO_MORE_CONTENTION_LOSER_ASSOCIATIONS Der Associationsaufbau von auBen wird abgelehnt weil in der lokalen Anwendung alle Contention Loser Associationen bereits aufgebaut sind 35 NO_MORE_CONTENTION_WINNER_ASSOCIATIONS Der Associationsaufbau von au en wird abgelehnt weil in der lokalen Anwendung alle Contention Winner Associationen bereits aufgebaut sind U5461 J Z135 6 339 Insert XPRJCT Meldungen von openUTM LU62 XPRJCT Bedeutung 36 CCR_BUT_NO_PARTNER_AET Der Partner hat keinen Application Entity Title angegeben obwohl CCR im Kontext ist 37 CCR_BUT_NO_OWN_AET In der lokalen Anwendung ist kein Application Entity Title angegeben obwohl CCR im Kontext ist 38 RESPONDING_APT_TOO_LONG Der in der Association confirmation angegebene Application Process Title ist l nger als von openUTM unterst tzt 39 RESPONDING_AEQ_TOO_LONG Der in der Association confirmation angegebene Application Entity Qualifier ist l n ger als von openUTM unterst tzt 40 ASS_ESTABLISHMENT_TIMEOUT Der von der lokalen Anwendung begonnene Associationsaufbau kann nicht in der vorgegebenen Zeit vollendet werden 41 PARTNER_IS_IN_QUIET_STATE Der Associationsaufbau wird abgelehnt weil der Partner in der lokalen Anwendung auf Quiet gesetzt ist 42 NO_SPACE_FOR_RCH Der PutElement Aufruf zum Abspeichern des Recovery Context Handle liefert einen schlechten Returnwert
280. imalen Dateigr e Der Wert 10 f r das Rundschreiben der Traces kann auf UNIX Systemen ge ndert werden durch Setzen der Shell Variablen U62_TRC_FILES vor dem Start von openUTM LU62 Wollen Sie also z B 20 Trace Dateien anlegen so sollten Sie folgendes Kommando einge ben U62_TRC_FILES 20 export U62_TRC_FILES opt lib utmlu62 u62_start t Mit der Shell Variablen U62_TRC_LEN kann man die L nge der Benutzerdaten im Trace beschr nken Mit der Shell Variablen U62_TRC_COMPRESS kann man eine Komprimierung der Trace Dateien auf UNIX Systemen erreichen Hierzu muss man U62_TRC_COMPRESS auf den Wert compress oder gzip setzen Zu beachten ist dabei dass die Programme com press bzw gzip ber die PATH Variable zu finden sind Auf Windows Systemen sind anstelle der Shell Variablen die gleichnamigen Variablen ber den Registrierungseditor des Betriebssystems zu setzen Diese Variablen befinden sich im Verzeichnis HKEY_LOCAL_MACHINE SOFTWARE Siemens openUTM LU62 CurrentVersion Trace auswerten Zur Auswertung des Instanz Trace steht das folgende Kommando zur Verf gung opt lib utmlu62 u62_adm f pl o outfile tracefile tracefile2 Beschreibung f tracefile File Es werden die Instanz Trace Dateien mit dem Namen tracefile bzw tracefile2 usw in lesbare Form aufbereitet und ausgegeben o outfile Name der Ausgabedatei p Es wird zus tzlich ein Protokoll Trace in die Datei outfile f 1 ow ausg
281. inistrieren LU6 2 Kopplungen mit openUTM LU62 Das CICS Anwendungsprogramm hat mit dem SYNCPOINT Kommando das UTM Anwen dungsprogramm aufgefordert die Transaktion zu beenden CICS sendet ein Request Commit und gibt das Senderecht ab verwendet also in diesem Fall kein echtes 2 Phase Commit Protokoll sondern ein vereinfachtes Protokoll bei dem es sp ter keine M glichkeit mehr hat die Transaktion zur ckzusetzen CICS verwendet dieses vereinfachte Protokoll immer dann wenn das CICS Anwendungsprogramm nur einen Auftragnehmer hat und vor dem SYNCPOINT Kommando kein ISSUE PREPARE abseizt TP_DEFERRED_END_DIALOGUE_REQ fd 1 10 47 45 line 6227 corr 2 gt Was im Protokoll Trace bei Erhalt des Request Commit nicht erkennbar war wird hier deut lich Das CICS Anwendungsprogramm hat die Nachricht vor dem SYNCPOINT mit SEND LAST gesendet und damit das Ende der Conversation eingeleitet openUTM LU62 sendet deshalb ein TP_DEFERRED_END_DIALOGUE_REQ an die UTM Anwendung TP_PREPARE_ALL_REQ fd 0 10 47 45 line 6274 corr 0 gt Danach sendet openUTM LU62 die Aufforderung zum Transaktionsende an die UTM An wendung TP_READY_ALL_IND fd 0 10 47 47 line 6350 corr 2 lt udata_len 97 Das UTM Anwendungsprogramm hat das Transaktionsende durch Absetzen von PEND FI best tigt Bei open UTM LU62 trifft deshalb ein TP_READY_ALL_IND ein TP_COMMIT_REQ fd 0 0 47 47 line 6605 corr 2 gt TP_COMMIT_IND fd
282. ion gesendet und beginnt eine Auftraggeber Auftragnehmer Beziehung Er enth lt unter anderem Transaktionscode Userid Passwort Already Verified Indikator Indi kator f r basic mapped conversation Sync Level LUWID FMH7 Error Description Der FMH7 sendet dem Partner eine Fehlermel dung Functional Unit Commit Funktionsgruppe im OSI TP Protokoll die zum Bilden von verteilten Transakti onen erforderlich ist Ob die Funtional Unit Commit verwendet werden darf wird beim Aufbau einer Assoziation zwischen den beiden Partnern ausgehandelt Auf einer Assoziation f r die die Functional Unit Commit vereinbart wurde k nnen OSI TP Dialoge mit oder ohne Functional Unit Commit laufen Ob die Functional Unit Commit bei einem OSI TP Dialog verwendet wird entscheidet das UTM Programm mit dem Parameter KCOF im APRO Aufruf bzw das LU6 2 Partner programm In SNA entspricht einem Dialog mit Functional Unit Commit eine Conversation mit Sync Level 2 U5461 J Z135 6 363 Fachw rter General Data Stream GDS Festlegung innerhalb des LU6 2 Protokolls wie die Benutzerdaten zu transferie ren sind GDS legt fest dass Benutzerdaten in Bl cke zu maximal 32763 Byte aufzutrennen sind mit jeweils einem 2 Byte gro en L ngenfeld und einem 2 Byte Feld zur Beschreibung des Datentyps Half Session Host Bei LU6 1 verwaltet jede LU eine H lfte einer Session die sogenannte Half Ses sion Die Half Session wird durch einen bis zu 8 Zei
283. ion zwischen diesem Prozess und u62_adm bzw u62_sta ist mittels Socket und Shared Memory realisiert U5461 J Z135 6 39 Konzepte und Funktionen von openUTM LU62 LU6 2 Kopplungen mit openUTM LU62 3 1 4 Recovery Funktionen Wenn die UTM und LU6 2 Anwendungsprogramme eine transaktionsgesicherte Kommu nikation betreiben sorgt openUTM LU62 im Falle eines Verbindungsverlusts oder eines Rechnerabsturzes f r ein Recovery der Transaktion der bei Update Transaktionen die Kon sistenz der beteiligen Datenbanken garantiert Geht w hrend des Transaktionsendes die Verbindung zwischen openUTM LU62 und der LU6 2 Anwendung oder der UTM Anwendung verloren so sorgt openUTM LU62 f r eine ordnungsgem e Beendigung der Transaktion sobald die Partner Anwendung wieder erreichbar ist openUTM LU62 schreibt in den kritischen Situationen w hrend der Transaktionsbeendi gung Log Records auf Platte Wenn die Transaktion komplett beendet ist werden diese Log Records wieder gel scht Kommt es w hrend des Transaktionsendes zu einem Rech nerabsturz oder zu einer abnormalen Beendigung von open UTM LU632 so bleiben die Log Records stehen Beim n chsten Start von openUTM LU62 werden die Log Records dann eingelesen und die offenen Transakionen unter Beteiligung der beiden Anwendungen zu Ende gef hrt Die Log Records werden auf UNIX Systemen pro openUTM LU62 Instanz in der Synclog Datei opt 1ib utm1u62 sync 10g loc_lu_alias gespeichert wobei loc_lu_al
284. ionscode ASAM_SET_TRANSSYNS aufgerufen Die zu initialisierende Anzahl an Transfer Syntaxen ist gr er als die Zahl der generierten ASA124 A Der Modul KCOASAM wurde mit dem Operationscode ASAM_SET_TRANSSYNS aufgerufen Die Anzahl der Elemente in einem Object Identifier der eine Transfer Syntax bezeichnet ist gr er als erlaubt ASA125 A Der Modul KCOASAM wurde mit dem Operationscode ASAM_ATTACH aufgerufen Die Referenz f r die Transfer Syntax enth lt einen ung lti gen Wert CDTNO2 M Modul KCOCOHF Funktion CheckDtnidTtnid Der Makro mGetBufferSpace lieferte den Returncode LB_NOREM CSNDO4 XM Ung ltiger Returncode nach Aufruf von PutElement zum Anfordern eines dynamischen Puffers f r Concatenator Sendedaten DMCAO00 M Modul KCOCODM Funktion ConnectDynMemArea Die Funktion ConnectSharedMem lieferte den Returncode MEM_NOMEM U5461 J Z135 6 269 Meldungen des Programms u62_tp Meldungen von openUTM LU62 REASON Grp Ursache DMDIOO XA Modul KCOCODM Funktion DynDynMemDmplinfo Der Parameter lt pnAreaEntries gt zeigt auf einen Wert kleiner oder gleich Null EHHPOO M Modul KCOXFEH Funktion HandlePresEvent Der Returncode von mGetBufferSpace war ungleich LB_OK EHRP01 MX Modul KCOXFEH Funktion ReloadPresEvent Der Makro mGetBufferSpace lieferte einen Returncode ungleich LB_OK EHSPO1 M Modul KCOXFEH Funktion StorePresEv
285. ird somit abgebrochen amp TPNAME gibt den Transaktionscode auf LU6 2 Seite an Das Anwendungsprogramm auf LU6 2 Seite z B das CICS Anwendungspro gramm muss ge ndert werden Fehler beim Resynchronisieren einer Transaktion LU6 2 Partner akzeptiert den Zustand amp STATE nicht TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Evtl muss openUTM LU62 kalt gestartet werden Eine Transaktion wurde wegen eines Verbindungsverlustes auf der LU6 2 Seite in der Commit Phase unterbrochen Beim Resynchronisieren mit dem LU6 2 Partner trat ein Fehler auf Der LU6 2 Partner akzeptiert den von openUTM LU62 vorge schlagenen Zustand der Transaktion nicht Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 306 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 421 Die Transaktion muss in diesem Fall durch manuelle Eingriffe beendet werden Auf Seite von openUTM LU62 besteht der einzig m gliche manuelle Eingriff in einer Beendigung der betroffenen openUTM LU62 Instanz und anschlie endem Kalt start Wenn es sich beim LU6 2 Partner um CICS handelt muss dort das Komman do CEMT SET CONNECTION NOTPENDING abgesetzt werden Es ist jedoch zu beachten dass durch diese manuellen Eingriffe eventuell Datenbank Inkonsisten zen entstehe
286. ispiel enth lt folgenden Ablauf 1 Exchange Logname 2 Aufruf einer CICS Transaktion durch ein UTM Anwendungsprogramm 3 Aufruf einer UTM Transaktion durch ein CICS Anwendungsprogramm Exchange Logname CICS openUTM LU62 openUTM TP_RESTART_COMPLETE_IND fd 0 10 46 22 line 506 corr 0 lt openUTM LU62 wurde gestartet Die Anmeldung an den XAP TP Provider war erfolgreich RECEIVE_ALLOCATE tpid 00067478 gt 10 46 22 line 1138 corr 0 tp_name X 06F2 sync_level CONFIRM_SYNC_LEVEL conv_type BASIC_CONVERSATION RECEIVE_IMMEDIATE tpid 00067478 gt 10 46 23 line 1264 corr 0 what_rcvd DATA_COMPLETE len 33 GDS_ID Exchange Logname Req warm CICS hat eine Conversation mit dem TP Namen X 06F2 aufgebaut und einen Exchange Log Name gesendet RECEIVE_AND_POST tpid 00067478 gt 10 46 23 line 1338 corr 0 hat_rcvd SEND SEND_DATA tpid 00067478 lt 10 46 24 line 1444 corr 0 send_type SEND_DATA_DEALLOC_SYNC_LEVEL len 58 GDS_ID Exchange Logname Rpl cold openUTM LU62 beantwortet den Exchange Log Name Erst ab diesem Zeitpunkt ist eine transaktionsgesicherte Kommunikation zwischen openUTM LU62 und CICS m glich GET_LU_STATUS tpid 00067478 lt 10 46 24 line 1487 corr 0 zero_sess YES active_sess 19 U5461 J Z135 6 67 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 Aufruf einer CICS Transaktion
287. ist das Resync TP X 06F2 Der LU6 2 Partner hat zum TP amp TPNAME von openUTM LU62 eine basic Conver sation aufgebaut Da basic Conversations nur ganz speziellen Transaktionspro grammen vorbehalten sind von denen openUTM LU62 ausschlieBlich das Resync TP X 06F2 unterst tzt weist openUTM LU62 die Conversation mit dem Code TP_NOT_AVAIL_NO_RETRY zurtick U5461 J Z135 6 313 Meldungen des Programms u62_tp Meldungen von openUTM LU62 531 532 533 534 540 Ankommende Conversation fuer das Resync TP X 06F2 abgelehnt Der angezeigte Sync Level amp SYNCLEVEL ist nicht gleich AP_CONFIRM_SYNC_LEVEL Der LU6 2 Partner hat eine Protokollverletzung begangen indem er das Resync TP mit einem Sync Level ungleich CONFIRM 1 gestartet hat Diese Mel dung zeigt also ein krasses Fehlverhalten des LU6 2 Partners an Ankommende Conversation fuer das Resync TP X 06F2 abgelehnt Die CCR Syntax ist gar nicht vereinbart Da ein Application Context UDTAC oder UDTDISAC konfiguriert wurde und damit auf OSI TP Seite keine Transaktionssicherung m glich ist sind auch Conversa tions mit Sync Level 2 zum LU6 2 Partner nicht erlaubt Ein Austausch der Log Namen Uber das Resync TP ist also nicht notwendig Wenn Sie Conversations mit Sync Level 2 verwenden wollen m ssen Sie einen Application Context UDTSEC oder UDTCCR verwenden Wenn Sie keine derartigen Conversations benutzen wollten k nnen Sie die Meldung ignoriere
288. ist mit openUTM LU62 nicht m glich Ein CICS Anwendungsprogramm als Auftragnehmer darf nie eigenst ndig SYNCPOINT oder ISSUE PREPARE verwenden sondern nur wenn es vom UTM An wendungsprogramm dazu aufgefordert wurde Basic Conversation ist nicht m glich Basic Conversation wird bei CICS mit Komman dos programmiert die mit GDS beginnen also z B EXEC CICS GDS ALLOCATE Ruft das CICS Auftragnehmerprogramm ISSUE ERROR auf wenn es vom UTM An wendungsprogramm zum Einleiten des Transaktionsendes aufgefordert wird so f hrt dies zu einem R cksetzen der Transaktion PIP Daten k nnen beim CONNECT PROCESS nicht verwendet werden Die Daten ge hen verloren Es ist nicht m glich auf unterschiedlichen Verbindungen zum selben Partner unter schiedliche Mode Namen zu verwenden Bei CICS ESA V4 1 wird der Mode Name bei der Session Definition eingestellt und kann damit an der Programmschnittstelle implizit ber den SYSID Parameter des ALLOCATE Aufrufs ausgew hlt werden Wenn eine LU6 2 Conversation zu openUTM LU62 nicht aufgebaut werden kann weil openUTM LU62 die entsprechende Verbindung zur UTM Anwendung nicht aufbauen kann so erh lt CICS keine detaillierten Ablehnungsgr nde Detaillierte Ablehnungs gr nde sind nur in der Protokolldatei von openUTM LU62 zu finden Ist der Generierungsparameter UTM ASYNC YES gesetzt so baut openUTM LU62 LU6 2 Conversations immer mit Sync Level 1 oder 2 auf nie mit Sync Level 0 Das Sync Level einer a
289. ist nicht in der Konfigurationsdatei enthalten Die Instanz fuer den lokalen LU Namen amp LUNAME laeuft bereits Die Instanz f r die lokale LU amp LUNAME ist bereits gestartet worden F r eine lokale LU darf nur eine einzige Instanz laufen Nicht genug Speicherplatz vorhanden Die Instanz beendet sich weil der Versuch tempor ren Speicher zu besorgen schiefgegangen ist Diese Meldung erscheint nur w hrend der Initialisierungs phase Interner Fehler aufgetreten W hrend der Initialisierung ist ein interner Fehler aufgetreten Die Instanz beendet sich daraufhin Sie sollten Diagnoseunterlagen sichern U5461 J Z135 6 265 Meldungen des Programms u62_tp Meldungen von openUTM LU62 013 015 016 017 018 019 Version amp VERSION amp DATE amp VERSIONID System amp SYSTEM amp SYSTEMVERSION Rechnername amp SYSTEMNAME Beim Start gibt die Instanz Informationen zur Programmversion von u62_tp und zur Systemumgebung aus Diese Informationen sind besonders bei der Fehlerdiagno se von Bedeutung Im Einzelnen enthalten die Variablen folgenden Inhalt amp VERSION enth lt die Versionsnummer des Programms u62_tp amp DATE ist das Erstellungsdatum des Programms u62_tp amp VERSIONID enth lt eine interne Kennung des Programms u62_tp amp SYSTEM ist der Name des Betriebssystems z B SunOS amp SYSTEMVERSION bezeichnet die Betriebssystem Version amp SYSTEMNAME ist der Host Name des lokalen Rec
290. keine von openUTM erstellten Datenstrukturen 254 U5461 J Z135 6 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen bergabe der FMH6 Parameter 8 2 bergabe der FMH6 Parameter in openUTM IMS und CICS 8 2 1 Die Belegung und Auswertungsm glichkeiten der Parameter im FMH6 in den verschiede nen Systemen zur Adressierung des Partners wird hier noch einmal genauer beschrieben Behandlung des Transaktionscodes in openUTM Der Transaktionscode kann auf unterschiedliche Weise an openUTM bermittelt werden 1 im Feld DPN des FMH6 2 im Feld PRN des FMH6 3 inden ersten 8 Bytes der Daten openUTM ermittelt den Transaktionscode bei Empfang vom fernen System auf folgende Art 1 Wertin DPN falls belegt und keine Angabe in SESCHA DPN 2 Wertin PRN falls belegt und Angabe SESCHA DPN name 3 aus den ersten 8 Bytes der Daten openUTM schickt den Transaktionscode an das ferne System auf folgende Art 1 wenn mit APRO IN adressiert wird Belegung entsprechend dem Parameterbereich des Aufrufs siehe APRO IN und INFO GN 2 Im Feld DPN falls keine Angabe in SESCHA DPN 3 Im Feld PRN falls Angabe SESCHA DPN name Dann steht in DPN des FMH6 der Name aus SESCHA DPN U5461 J Z135 6 255 bergabe der FMH6 Parameter LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen 8 2 2 8 2 3 Behandlung des Transaktionscodes in IMS IMS schickt den Transaktionscode normalerweise in den Daten DPN ist mit dem Namen des ISC Edit is
291. kros oder online RDO Resource Definition Online erfolgen Bei neueren CICS Versionen wird zunehmend nur noch die RDO Defini tion beschrieben Deshalb wird diese hier zur Beschreibung benutzt F r eine Verbindung mit openUTM m ssen ber RDO definiert werden CONNECTION SESSIONS In der System Initialization Table SIT wird au erdem der Name der CICS Anwendung angegeben DFHSIT APPLID cics_netname 1 8 Zeichen langer Name mit dem der SNA Netzname f r die CICS Anwendung festgelegt wird Dieser Name muss mit dem RNETNAME Operanden in der korre spondierenden LPAP Anweisung der UTM Generierung bereinstimmen U5461 J Z135 6 209 CICS Definitionen f r openUTM CICS Sessions openUTM CICS Kopplung ber LU6 1 DEFINE CONNECTION Mit dieser Definition wird das ferne System in diesem Fall die UTM Anwendung beschrieben Sie entspricht damit der LPAP Anweisung in der UTM Generierung DEFINE CONNECTIO connection_name GROUP group_name NETNAME netname ACCESSMETHOD VTAM PROTOCOL LU61 DATASTREA USER RECORDFORMAT U VB Hierbei haben die Operanden folgende Bedeutungen CONNECTION connection_name 1 4 Zeichen langer Name zur Bezeichnung der UTM Anwendung Dieser Name existiert nur innerhalb von CICS Er muss in den CICS Programmen beim ALLOCATE im Parameter SYSID angegeben werden wenn das CICS Programm einen UTM Transaktionscode aufrufen will Er muss auch in einer Session Definiti on vorkommen GROUP group_nam
292. l TRANSIT Konfiguration __ XPU L XLU m KEINK sens NAME PARTL 5 sdIc NAME PARTL5J ibmhost luOgwl PU TYP F LOCADDR 5 L6LO LINE Leitung zu UNIX P6L01 PU PUTYPE 2 UTMMCHP LU LOCADDR 5 MODETAB MODLU6 DLOGMOD MODLU6 MODLU6 MODETAB MODETAB ENTRY f r LU6 1 MODEENT LOGMODE MODLU6 FMPROF X 12 FM PROFILE 18 TSPROF X 04 TS PROFILE 4 PRIPROT X B1 SECPROT X B1 COMPROT X 70A0 RUST ZE X 8787 SEND RECEIVE 1024 BYTES PSERVIC X 060130000000300000000000 LU6 1 MODEEND END VBUILD TYPE APPL CICSCGK APPL CICS Anwendung UTM und UTMGW1 U5461 J Z135 6 215 Definieren von CICS Transaktionen openUTM CICS Kopplung ber LU6 1 6 3 Definieren von CICS Transaktionen 6 3 1 Lokale Transaktionen CICS Transaktionen werden ber RDO definiert DEFINE TRANSACTION lt transaction code gt PROGRAM lt program name gt INDOUBT WAIT Die Operanden haben folgende Bedeutung TRANSACTION lt transaction code gt 1 4 Zeichen langer Transaktionscode f r die CICS Transaktion Dieser Name muss mit dem RTAC Operanden in der korrespondierenden LTAC Anweisung der UTM Generierung bereinstimmen PROGRAM lt program name gt Name eines CICS Programms INDOUBT WAIT Diese Angabe ist n tig um nach Sessionfehlern eine ordnungsgem e Synchroni sation mit openUTM zu erreichen 216 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 Definieren vo
293. l auf 1 steht um 1 erh ht U5461 J Z135 6 65 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 3 3 10 Protokoll Trace Im Protokoll Trace finden Sie eine verk rzte Darstellung des Protokollflusses auf LU6 2 und auf OSI TP Seite Da openUTM LU62 f r die LU6 2 Kommunikation die Programm schnittstelle APPC und f r die OSI TP Kommunikation die Programmschnittstelle XAP TP benutzt sind in diesem Trace auch einige Eigenschaften dieser beiden Schnittstellen sicht bar Auf der LU6 2 Seite werden bei jeder Nachricht der Name des APPC Aufrufs die von der LU6 2 Basis Software TRANSIT SERVER SNAP IX bzw IBM Communications Server vergebene TP ID die Verarbeitungsrichtung und eventuell weitere Parameter im Trace aus gegeben Die Verarbeitungsrichtung ist mit einem Pfeil gekennzeichnet Ein Pfeil nach links kennzeichnet eine von openUTM LU62 ausgehende Nachricht ein Pfeil nach rechts eine bei openUTM LU62 eingehende Nachricht Beim Start einer openUTM LU62 Instanz und nach einem Verbindungsverlust werden zun chst Verwaltungsdaten zwischen open UTM LU62 und dem LU6 2 Partner ausgetauscht Hierzu wird der Transaktionscode X 06F2 ver wendet Diese Protokollfl sse sind mit einem einfachen Pfeil gt gekennzeichnet Pro tokollfl sse die von den Anwendungsprogrammen kommen sind mit einem Doppelpfeil gt gekennzeichnet Auf der OSI TP Seite werden bei jeder Nachricht der Name des XAP TP Aufrufs der vom
294. lassen 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 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 Diese Beschreibung ist nur als PDF Dokument erh ltlich online und auf der openUTM Produkt DVD Die Arbeit mit der grafischen Bedienoberfl che ist in der zugeh rigen Online Hilfe beschrieben Kopplung mit der IBM Welt Das vorliegende Handbuch Verteilte Transaktionsverarbeitung zwischen openUTM und CICS IMS und LU6 2 Anwendungen beschreibt wie Sie aus Ihrer UTM Anwendung mit Transaktionssystemen von IBM kommunizieren 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 U5461 J Z135 6 17 Wegweiser durch die Dokumentation zu openUTM Einleitung 1 2 2 Dokumentation zum openSEAS Prod
295. le Details bei der Erstellung von CICS Programmen mit Dis tributed Transaction Processing CICS Application Programming Guide Das Dokument beschreibt die Konzepte der CPI C Anwendungsprogrammierung Unter anderem wird auch Distributed Transaction Processing erw hnt CICS Application Programming Reference Das Dokument enth lt die vollst ndige Beschreibung der CICS Programmschnittstelle CICS Supplied Transactions Beschreibung der CICS Administrationskommandos CICS Resource Definition Guide Beschreibung der Parameter zur CICS Definition z B Connection und Session Definition IMS Version 9 Application Programming Design Guide Das Kapitel 7 beschreibt das Design von LU6 2 Anwendungsprogrammen IMS Version 9 Application Programming Transaction Manager Das Dokument enth lt die Details zur Anwendungsprogrammierung mit DL I 390 U5461 J Z135 6 Literatur IMS Version 9 Installation Volume 2 System Definition and Tailoring Das Dokument enth lt die Beschreibung der IMS Systemdefinition z B die Makros zur Definition von Transaktionscodes IMS Version 9 Administration Guide Transaction Manager In den Kapiteln 19 und 20 wird das Einrichten von LU6 2 Kopplungen beschrieben IMS Version 9 Command Reference Beschreibung der IMS Administrationskommandos U5461 J Z135 6 391 Literatur Dokumentation zu SNAP IX und IBM Communications Server Die folgende Liste gibt eine unverbindliche bersicht ber d
296. ll Expedited function call stopped due to expedited data flow control shortage Continue after event SXGO S_GO Presentation call Function call not successful apref invalid Local function call Invalid connection reference ACSE call Function call not successful apref resp aref invalid 5 Invalid waiting point reference 6 Invalid application reference 7 Waiting period to obtain a lock on a shared association expired XPERR Bedeutung 1 No memory available temporary 100 Call sequence error 101 Application not attached 102 Sending of data not allowed wait for GO event 103 Internal error 104 Shared association is not locked 200 Missing ACSE presentation reference 201 Invalid ACSE presentation reference 202 Presentation call missing AVX list o_attach ACSE call missing application reference 203 Presentation call invalid AVX list ACSE call invalid application reference 334 U5461 J Z135 6 Meldungen von open UTM LU62 Insert XPERR XPERR Bedeutung 204 Presentation call invalid abstract syntax name in AVX ACSE call missing ACSE parameters 205 Presentation call invalid decoding mode in AVX ACSE call missing presentation parameters 206 Presentation call invalid user data length ACSE call missing session parameters 207 Presentation call invalid context id in p_udl ACSE call
297. lle eines Verbin dungsverlustes oder Rechnerabsturzes alle an der Transaktion beteiligten Sys teme ber den Ausgang der Transaktion einigen Im LU6 2 Protokoll verwendeter Name der eine Anwendung z B eine UTM oder CICS Anwendung ber ihre gesamte Lebensdauer d h zwischen zwei Kaltstarts charakterisiert Die Log Names m ssen gem LU6 2 zwischen den beiden Resync TPs ausgetauscht werden bevor nach einem Verbindungsab bruch oder Systemausfall der Wiederanlauf Compare States gestartet wird Das Austauschen der Log Names dient dazu einen einseitigen Kaltstart zu identifi zieren Log Record Auf sicheren Speicher im allgemeinen Plattenspeicher geschriebene Informa tion ber den Zustand einer offenen Transaktion Die Log Records dienen dazu im Fall eines Rechnerabsturzes die Transaktion wieder aufsetzen zu k nnen Nach Beendigung der Transaktion werden die Log Records wieder gel scht Mapped Conversation Typ einer LU6 2 Conversation bei dem sich das Anwendungsprogramm nicht um die Verpackung der Daten mittels GDS k mmern muss Gegenteil Basic Conversation Normale Anwendungsprogramme nutzen blicherweise immer Mapped Conversation Mode Beschreibt die Eigenschaften von Sessions wie z B Maximalzahl von paralle len Sessions RU Sizes Pacing Werte Ein Mode hat einen Mode Namen Mode Name Maximal achtstelliger Name der beim Sessionaufbau vereinbart wird Ein Mode Name ist ein symbolischer Name f r eine Liste von
298. logschritt hat dieselbe Wirkung wie ein PEND FR 7 Einschrittvorgang ohne Transaktionssicherung gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL O SEND INVITE WAIT CONVID FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MPUT NE PEND FI lt Daten CEB RECEIVE CONVID SEND Client gan RETURN 8 Verarbeitungsquittung ohne Transaktionssicherung gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 1 SEND INVITE CONFIRM CONVID FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MGET KCRMGT H MPUT NE PEND FI lt Daten CEB 0K EIBERR X 00 RECEIVE CONVID SEND Client 425s RETURN U5461 J Z135 6 129 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 9 Negative Verarbeitungsquittung ohne Transaktionssicherungung gt RECEIVE Client ALLOCATE CONNECT PROCESS CONVID SYNCLEVEL 1 SEND INVITE CONFIRM CONVID FMH5 Daten gt INIT PU ENDTA 0 SEND Y MGET VGST 0 TAST U MGET KCRMGT H MPUT EM PEND FI lt FMH7 0K EIBERR X FF RECEIVE CONVID EOC SEND Client EHER RETURN 130 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren Start eines UTM Asynchron Vorgangs aus einem CICS Anwendungsprogramm 10 Mit Transaktionssicherung gt RECE
299. lt Ist dies nicht m glich so liegt ein schwerwiegender Fehler vor der zum Abbruch des OSI TP Dialogs f hrt 298 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp 379 380 381 382 383 Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Keine Unterstuetzung von Initialisierungsdaten openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit angeh ngten Initialisierungsdaten empfangen Solche Daten sind nur dann erlaubt wenn der Application Context UDTSEC ist In diesem Fall sind dies gerade die Security Daten Benutzerkennung und Passwort bzw der Already verified In dikator F r alle anderen Application Contexts ist nicht klar wie die Initialisierungs daten umzukodieren sind um sie als sogenannte PIP Daten im ALLOCATE dem LU6 2 Partner zu bermitteln Daher lehnt open UTM LU62 hier den OSI TP Dia logwunsch ab Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Fehlerhafte Codierung der Security Daten openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit Initialisierungsdaten empfangen Da der Application Context UDTSEC ist wer den diese Daten als Security Daten interpretiert und gem ASN 1 dekodiert Geht diese Dekodierung schief so liegt ein schwerwiegender Fehler vor der zur
300. ltet c k Ohne Angabe wird standardm ig ein Warmstart durchgef hrt Start Typ w C Cold Es wird ein Kaltstart durchgef hrt Der Kaltstart l scht alle Recovery Informationen Diesen Parameter sollten Sie nur in Ausnahmef llen benut zen Siehe hierzu Seite 40 k Lukewarm Es wird ein Warm Start durchgef hrt bei dem allerdings alle noch offenen Transaktionen verworfen werden Die Log Namen bleiben dagegen erhalten Dies bedeutet dass die LU6 2 Partner Anwendung nichts von dem Verwerfen der offenen Transaktionen erf hrt Dies ist zum Beispiel dann notwendig wenn das Partnersystem entweder durch Fehler oder durch administrative Eingriffe die offenen Transaktionen bereits verworfen hat aber ein Kaltstart wegen der Auswirkungen auf ande re Aufgaben im Partnersystem nicht praktikabel ist Das Partnersystem muss in diesem Fall einen Kaltstart durchf hren Zum Beispiel erfordert in IMS ein Kaltstart das Beenden und den Neustart des gesamten IMS und damit eine vollst ndige Unterbrechung des Be triebs was in Produktivsystemen naturgem nicht erw nscht ist Durch Starten mit dem Parameter k k nnen einseitig h ngengebliebene Transak tionen bereinigt werden ohne dass im Partnersystem weitere Ma nahmen insbesondere eine Unterbrechung notwendig sind Beispiel Start mit Zeitmessung im Instanz Trace und XAP TP Trace auf UNIX Systemen opt 1ib utmlu62 u62_start ton in 3 xap Nach dem erfolgreichen Start ersch
301. m LU6 2 Partner zugrundeliegt ist ein schwerwiegender Fehler aufgetreten z B durch Ausfall der Link Verbindung zur Partner PU oder durch administrativen Abbau aller Sessions mit dem Kommando u62_adm as openUTM LU62 bricht daraufhin den OSI TP Dialog zum OSI TP Partner d h zur UTM Anwendung abnormal ab Conversation zum LU6 2 Partner TP Name amp TPNAME LU6 2 Seite ist Auftraggeber wegen Conversation Fehler abgebrochen Siehe Kommentar zur Meldung 334 Auf Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber User Control Daten empfangen gt Abbruch der Conversation durch openUTM LU62 Der LU6 2 Partner hat an openUTM LU62 sogenannte User Control Daten gesen det Da diese nicht ins OSI TP Protokoll umgesetzt werden k nnen bricht openUTM LU62 die Conversation zum LU6 2 Partner und den OSI TP Dialog mit dem OSI TP Partner d h mit der UTM Anwendung ab Auf Conversation zum LU6 2 Partner TP Name amp TPNAME LU6 2 Seite ist Auftraggeber User Control Daten empfangen gt Abbruch der Conversation durch openUTM LU62 Siehe Kommentar zur Meldung 336 Auf Conversation zum LU6 2 Partner TP Name amp TPNAME OSI TP Seite ist Auftraggeber wurde AP_STATE_CHECK fuer ein RECEIVE Verb gemeldet gt Abbruch der Conversation durch openUTM LU62 Die LU6 2 Basis Software hat beim Empfang eines Datenpakets vom LU6 2 Part ner einen formalen Codierungsfehler der Daten festgestellt Daraufhin hat
302. m TNSX oder direkt in der open UTM LU62 Generierung und in der OSI CON Anweisung der UTM Generierung F r jede Instanz von openUTM LU62 muss eine eigene Port Nummer vergeben werden 38 Inder OSI CON Anweisung der UTM Generierung muss der Name des Rechners eingetragen werden auf dem openUTM LU62 l uft Auf UNIX Systemen ist dies blicherweise der DNS Rechnername z B local f r den eigenen Rechner auf BS2000 Systemen der BCAM Name 106 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren 39 40 41 42 43 Die IP Adresse des Rechners auf dem openUTM LU62 l uft ist blicherweise im DNS eingetragen Bei Verwendung von openUTM unter BS2000 OSD wird die IP Adresse mit dem Kommando BCIN eingetragen Die von der UTM Anwendung verwendete AE erh lt in der openUTM Generierung einen symbolischen Namen Dieser kommt innerhalb der open UTM Generierung an zwei Stellen vor Die Stellvertreter AE und somit das CICS System erh lt in openUTM einen symbo lischen Namen den sogenannten LPAP Namen Dieser Name wird in der openUTM Generierung mit einer OSI LPAP Anweisung generiert Die OSI CON Anweisung muss auf diesen Namen verweisen Wenn von der UTM Anwendung ein CICS Programm adressiert werden soll muss dieser Name auch in einer LTAC Anweisung oder im UTM Programm beim APRO Aufruf angegeben werden Wenn von der UTM Anwendung aus ein CICS Programm adressiert werden soll so
303. me meist nicht um das Weitersenden der Benutzerkennung k mmern UTM Anwendungsprogramme k n nen bei APRO durch Setzen von KCSECTYP S die Benutzerkennung an das CICS System weitersenden CICS Programme senden immer die Benutzerkennung weiter Wie oben erw hnt kann sie aber nur dann an die openUTM Anwendung bertragen werden wenn UDTSEC als Appli cation Kontext generiert wurde Ist UDTSEC nicht als Application Kontext generiert und sendet das CICS Programm eine Benutzerkennung so baut openUTM LU62 die LU6 2 Conversation ab Werden in openUTM Umgebung andere Benutzerkennungen als in CICS Umgebung ver wendet so kann das UTM Anwendungsprogramm als Auftraggeber selbst Benutzerken nung und Passwort setzen Hierf r muss der Parameter KCSECTYP P bei APRO gesetzt werden Die Benutzerkennung muss in KCUSERID das Passwort in KCPSWORD einge tragen werden Zu beachten ist dabei dass KCUIDTYP und KCPWDTYP auf P oder T gesetzt werden Der Typ Octet String wird von openUTM LU62 nicht unterst tzt Es ist zu beachten dass beim APRO in diesem Fall alle nicht verwendeten Felder des 2 Parameter bereichs gel scht werden m ssen 82 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren Von einem CICS Programm kann dagegen immer nur die Benutzerkennung gesendet wer den mit dem es aufgerufen wurde Ein CICS Programm kann kein Passwort an eine UTM Anwendung senden Werden von CICS aus mehr
304. missing application context name 208 Presentation call invalid next parameter in p_udl ACSE call invalid application context name 209 Presentation call invalid pdv parameter in p_udl ACSE call invalid calling AP Title 210 Presentation call invalid chaining parameter ACSE call invalid calling AE Qualifier 211 Presentation call missing token parameter ACSE call invalid called AP Title 212 Presentation call invalid token parameter ACSE call invalid called AE Qualifier 213 Presentation call missing rtype parameter ACSE call invalid responding AP Title 214 Presentation call invalid rtype parameter ACSE call invalid responding AE Qualifier 215 Presentation call missing type parameter ACSE call missing called p_address 216 Presentation call invalid type parameter ACSE call invalid called p_address 217 Presentation call invalid syncp parameter ACSE call missing calling p_address 218 Presentation call missing syncp parameter ACSE call missing responding p_address 219 Presentation call invalid ctxlst parameter ACSE call no mode parameter 220 Presentation call invalid number of abstract syntaxes passed to OSS ACSE call invalid mode parameter 221 Presentation call invalid transfer syntax name ACSE call missing result 222 Presentation call invalid number of transfer syntaxes ACSE call invalid result U5461 J Z135 6 335
305. mit und ohne Functional Unit Hand shake d h bei APRO mit KCOF B an den LU6 2 Partner weitergegeben wird NO openUTM LU62 startet diese Vorg nge mit Sync Level 0 NONE YES openUTM LU62 startet diese Vorg nge mit Sync Level 1 CONFIRM Der Wert YES ist notwendig wenn aus dem UTM Anwendungsprogramm mittels APRO AM ein Vorgang beim LU6 2 Partner ohne Transaktionssicherung gestartet werden soll Verwendet eine UTM Anwendung APRO DM mit KCOF B und APRO AM mit KCOF B so sollte f r beide Typen der Kommunikation jeweils eine eigene Instanz von open UTM LU62 eingerichtet werden wobei die erste Instanz mit UTM ASYNC NO und die zweite Instanz mit UTM ASYNC YES generiert wird U5461 J Z135 6 51 openUTM LU62 generieren LU6 2 Kopplungen mit openUTM LU62 3 2 3 Generierungsprogramm starten Mit dem Generierungsprogramm u62_gen erzeugen Sie aus einer Generierungsdatei eine bin re Konfigurationsdatei Gleichzeitig wird die Generierungsdatei auf logische Fehler berpr ft u62_gen darf auf UNIX Systemen nur vom Systemverwalter aufgerufen werden Auf UNIX Systemen k nnen Sie u62_gen direkt aus der Shell aufrufen Auf Windows Syste men empfiehlt es sich mit Start gt Programme gt openUTM LU62 gt Kommando Eingabe eine DOS Shell zu erzeugen Unter dieser DOS Shell kann dann das folgende Kommando ohne den Vorspann opt 1ib utmlu62 aufgerufen werden Aufrufsyntax opt lib utmlu62 u62_gen f conf_file gen_file Beschre
306. mmando hat folgende Syntax EXEC CICS SYNCPOINT ROLLBACK ISSUE PREPARE Mit diesem Kommando wird der Partner aufgefordert das Transaktionsende einzuleiten Das Kommando ist nur bei Sync Level 2 erlaubt Das Kommando hat folgende Syntax EXEC CICS ISSUE PREPARE CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session ISSUE PREPARE unterscheidet sich von SYNCPOINT dadurch dass nur einer von even tuell mehreren Auftragnehmer Vorgangen zum Einleiten des Transaktionsendes aufgefor dert wird Dem ISSUE PREPARE muss spater noch ein SYNCPOINT oder SYNCPOINT ROLLBACK folgen Bei einer CICS CICS Kopplung kann der Auftragnehmer Vorgang nach ISSUE PREPARE noch mittels ISSUE ERROR eventuelle Fehler melden und dem Auftraggeber die Entschei dung berlassen ob er SYNCPOINT oder SYNCPOINT ROLLBACK durchf hren will Eine UTM Anwendung kann jedoch den dem ISSUE ERROR entsprechenden Aufruf nicht ab setzen sondern kann nur mit einer PEND Variante antworten Somit liegt nach dem ISSUE PREPARE die Entscheidung Uber Transaktionsende oder R cksetzen der Transaktion beim UTM Anwendungsprogramm 114 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren FREE Das Kommando gibt eine mittels ALLOCATE belegte Session wieder frei Das Kommando hat folgende Syntax EXEC CICS FREE CONVID name CONVID name Bezeichnet die durch ALLOCATE reservierte Session WAIT CONVID Das Kommando sorgt
307. n Ankommende Conversation fuer das Resync TP X 06F2 abgelehnt Initialisierungsdaten werden nicht unterstuetzt Diese Meldung zeigt einen Protokollversto des LU6 2 Partners an der beim Auf bau der Conversation zum Resync TP sogenannte PIP Daten mitgesendet hat Ankommende Conversation fuer das Resync TP X 06F2 abgelehnt Der Alias Name amp ALSNAME der Partner LU stimmt nicht mit dem konfigurierten Namen amp CONFNAME ueberein Der LU6 2 Partner will eine Conversation zum lokalen Resync TP aufbauen Der LU Name des LU6 2 Partners stimmt aber nicht mit dem bei openUTM LU62 mit tels REM LU ALIAS generierten Namen berein Es liegt folglich ein Fehler in der Gesamtkonfigurierung vor Eine auf dem lokalen Rechner residierende LU die von openUTM LU62 als Stellvertreter LU f r eine UTM Anwendung benutzt werden soll kann eine Kommunikation nur zu einer bestimmten Partner LU unterhalten Conversation zum Resync TP X 06F2 abgebrochen Die LU6 2 Basis Software ist gestoppt worden 314 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 541 Conversation zum Resync TP X 06F2 abgebrochen Conversation Failure Diese Fehlermeldung wird ausgegeben wenn die Conversation zum Resync TP durch einen schwerwiegenden Fehler auf der darunterliegenden Session abgebro chen wird etwa durch Ausfall der Link Verbindung zur Partner PU oder durch ad ministratives Beenden aller bestehenden Sessions
308. n amp OLDNAME nach amp NEWNAME Kein Aufbau von Conversations moeglich openUTM LU62 ermittelt bei einem Kaltstart den in der LU6 2 Basis Software z B in TRANSIT konfigurierten Netzwerknamen der Partner LU amp ALIASNAME in TRANSIT Konfigurationsparameter REM LU ALIAS mit Hilfe eines sogenannten Control Operator Aufrufs Bei jeder neu aufgebauten Conversation zum LU6 2 Part ner wird dann berpr ft ob dieser Name noch immer korrekt ist oder in der Zwi schenzeit durch Umkonfigurieren ver ndert wurde amp NEWNAME Im Fehlerfall wird die Conversation sofort wieder abgebaut 276 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 043 044 045 046 047 048 049 Der Netzname der Partner LU amp ALIASNAME ist wieder richtiggestellt openUTM LU62 hatte festgestellt dass der Netzwerkname der Partner LU in der LU6 2 Basis Software z B in TRANSIT umkonfiguriert worden war und deshalb die Meldung 042 ausgegeben Wenn bei dem Versuch eines Conversation Aufbaus erkannt wird dass der Netzwerkname in der LU6 2 Basis Software wieder richtig gestellt wurde wird zur Information diese Meldung ausgegeben Der Netzname der lokalen LU amp ALIASNAME ist umkonfiguriert worden von amp OLDNAME nach amp NEWNAME Kein Aufbau von Conversations moeglich Diese Meldung hat die gleiche Bedeutung wie Nummer 042 mit dem Unterschied dass nicht die Partner LU sondern die lokale LU von der Anderung de
309. n Das Hinzuf gen des end bracket Indikators zur Nachricht kann mit den CICS Kommandos SEND LAST RETURN oder SEND LAST SYNCPOINT erreicht werden Bei openUTM ist ein Sicherungspunkt immer mit dem Senden einer vollst ndigen Dia log Nachricht verbunden Ein CICS Vorgang muss deshalb daf r Sorge tragen dass beim SYNCPOINT Kommando das Senderecht change direction an den UTM Part ner Vorgang bertragen wird openUTM erwartet immer den Funktion Management Header ATTACH f r die Adres sierung von Vorg ngen Im CICS Auftraggeber Vorgang muss das CICS Kommando BUILD ATTACH verwendet werden Der UTM Transaktionscode kann nicht an den Be ginn der Nachricht gestellt werden U5461 J Z135 6 219 CICS Kommandos f r CICS Auftraggeber Vorg nge openUTM CICS Kopplung ber LU6 1 6 5 CICS Kommandos f r CICS Auftraggeber Vorg nge Im folgenden wird beschrieben wie aus einer CICS Anwendung ein UTM Vorgang gestartet wird ALLOCATE Mit diesem Kommando versucht ein CICS Auftraggeber Vorgang eine Session f r einen Auftragnehmer Vorgang zu belegen Das Kommando hat folgende Syntax EXEC CICS ALLOCATE SYSID name EPROFILE name LNOQUEUE SYSID name spezifiziert den Namen f r die ferne UTM Anwendung wie er in einer CONNECTION Definition angegeben wurde Unmittelbar nach der Belegung der Session ist der Name der belegten Session im Feld EIBRSRCE des exec interface blocks EIB zu finden Dieser Name muss bei allen folgenden Au
310. n so muss es statt dessen die LU 5C anspre chen Somit sind die LUs 4A 4B 4C die Stellvertreter f r die UTM Anwendung 4 d h f r die AE 4 im SNA Netz Die AEs 1A 1B sind die Stellvertreter f r das CICS System 1 d h f r die LU 1 im ISO Netz Architektur von open UTM LU62 openUTM LU62 nutzt zur OSI TP Kommunikation die von X Open standardisierte System Programmschnittstelle XAP TP Diese Programmschnittstelle wird auch in den Produkten openUTM und openUTM Client Tr gersystem OpenCPIC benutzt Der XAP TP Provider setzt auf der Komponente OSS auf OSS wiederum setzt in einigen Betriebssystemen auf CMX bei anderen auf PCMX auf XAP TP Provider und OSS sind im Produkt openUTM LU62 enthalten Zur LU6 2 Kommunikation nutzt openUTM LU62 die APPC Programmschnittstelle Diese Programmschnittstelle wird jeweils durch die LU6 2 Basis Software realisiert Als LU6 2 Basissoftware kommen in Frage e TRANSIT SERVER und TRANSIT CPIC auf Solaris e SNAP IX auf Solaris e IBM Communications Server auf Windows Linux oder AIX openUTM LU62 setzt nicht nur LU6 2 Protokolle in OSI TP Protokolle um und umgekehrt sondern stellt einen eigenen Knoten im Transaktionsbaum dar schreibt also Log Records und f hrt im Falle eines Verbindungs oder Rechnerausfalls eigenst ndig ein Transaktions Recovery auf OSI TP Seite und auf LU6 2 Seite aus U5461 J Z135 6 37 Konzepte und Funktionen von openUTM LU62 LU6 2 Kopplungen mit openUTM LU62
311. n CICS Transaktionen 6 3 2 Ferne Transaktionen Die UTM Transaktionen werden in CICS normalerweise nicht definiert Der Transak tionscode erscheint nur in den Programmen Ferne Dialog Transaktionen werden durch den Aufruf BUILD ATTACH und Asynchron Programme mit START festgelegt Beim START Aufruf darf der Transaktionscode jedoch nur 4 BYTES lang sein Dies kann man in der UTM Generierung ber cksichtigen oder es wird diese Transaktion ber RDO definiert DEFINE TRANSACTION lt local transaction code gt REMOTESYSTEM lt UTM Systemid gt REMOTENAME lt remote transaction code gt Die Operanden haben folgende Bedeutung TRANSACTION lt local transaction code gt 1 4 Zeichen langer lokaler Transaktionscode f r einen UTM Vorgang Dieser Name wird im START Aufruf verwendet REMOTESYSTEM lt UTM Systemid gt Name der UTM Anwendung in der CICS Anwendung vgl Seite 210 REMOTENAME lt remote transaction code gt 1 8 Zeichen langer Transaktionscode f r einen Vorgang in der UTM Anwendung Dieser Name muss mit dem TAC Namen in der korrespondierenden TAC Anwei sung der UTM Generierung bereinstimmen Beispiel TAC ATAC0000 DEFINE TRANSACTION UASY TYPE A REMOTESYSTEM UTMP grits asia gt REMOTENAME ATACOOOO U5461 J Z135 6 217 CICS Programmierung bei Kopplung mit openUTM openUTM CICS Kopplung ber LU6 1 6 4 CICS Programmierung bei Kopplung mit openUTM 6 4 1 Die Kommunikation zwischen CI
312. n Protokollelements FMH7 FOLLOWS REQUESTED RESOURCES NOT AVAILABLE LPAP NOT ALLOWED INVALID BIND FUNCTION ABORT LUSTAT CMD erhalten und CDI 0 und ERI 0 FUNCTION ABORT Eine Dialog Nachricht wurde mit BB empfangen Die Nachricht kann nicht verarbeitet werden weil z B der TAC ung ltig ist der Pagepool voll ist die Nachricht mit EB empfangen wurde FUNCTION ABORT Die Lange der empfangenen Nachricht ist ung ltig oder das L ngenfeld einer Nachricht im VLVB Format ist ung ltig FUNCTION ABORT Die Gesamtl nge der empfangenen Nachrichtenteile ist zu gro gr er als 32767 U5461 J Z135 6 259 LU6 1 Sense Data Fehlerdiagnose 0864 0108 0864 C5D9 0864 C5E2 0864 D9E2 0864 D9E4 0866 D9E2 0866 D9E4 0867 0000 1002 0000 1003 0000 1008 0106 2001 0000 2002 0000 2003 0000 2004 0000 2005 0000 2007 0000 2008 0000 2009 0000 200A 0000 200B 0000 200C 0000 200D 0000 4001 0000 4003 0000 4004 0000 4006 0000 FUNCTION ABORT End of Chain aber kein Nachrichten teil ende D h das im VLVB Format erhaltene L ngenfeld zeigt eine zu gro e L nge an FUNCTION ABORT PEND ER vom UTM Anwendungsprogramm FUNCTION ABORT PEND ER durch openUTM FUNCTION ABORT PEND RS durch open UTM Z B Der lokale Vorgang wurde beendet und die letzte Eingabenachricht enth lt CD oder DR2 FUNCTION ABORT PEND RS vom UTM Anwendungsprogramm FUNCTION ABORT REC RESPONSE PEND RS durch openUTM FUNCTION
313. n bei einem OSI TP Partner der keine UTM An wendung ist 294 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 357 358 359 360 361 362 Protokollverstoss AP_TP_BEGIN_TRANSACTION_IND erhalten TP Name amp TPNAME OSI TP Seite ist Auftraggeber Siehe Kommentar zur Meldung 356 Die Laenge amp LEN der vom OSI TP Partner empfangenen User Daten ueber schreitet den Maximalwert von amp MAXLEN TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Der OSI TP Partner d h die UTM Anwendung hat Netto Daten der L nge amp LEN zu openUTM LU62 gesendet Zum LU6 2 Partner k nnen allerdings nur amp MAXLEN Bytes bei TRANSIT als LU6 2 Basis Software sind das 32763 Bytes in einem Datenpaket weitergereicht werden openUTM LU62 beendet OSI TP Dialog wie Conversation daraufhin abnormal Das UTM Anwendungsprogramm muss also ge ndert werden Die Laenge amp LEN der vom OSI TP Partner empfangenen User Daten ueber schreitet den Maximalwert von amp MAXLEN TP Name amp TPNAME OSI TP Seite ist Auftraggeber Siehe Kommentar zur Meldung 358 Ankommender Dialogwunsch abgelehnt OSI TP Seite ist Auftraggeber Kein lokaler TPSU Title angegeben openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication ohne Angabe eines TPSU Title d h ohne Angabe des Transaktionscodes empfan gen Der OSI TP Dialogwunsch wird von openUTM LU62 abgelehnt Diese Mel dung kann nur auftreten bei einem OSI
314. n bzw confirmation wird keine TP INITIALIZE RI RC PDU mitgeliefert 22 OSITP_NO_VERSION_1 Der Partner unterst tzt die Version 1 des OSI TP Protokolls nicht 23 OSITP_RCH_WRONG_LENGTH Der bei der TP INITIALIZE indication bzw TP INITIALIZE confirmation mitgegebene Recovery Context Handle hat eine Lange die von openUTM nicht unterst tzt wird 24 NO_CCR_INITIALIZE Die CCR INITIALIZE RI PDU fehlt 25 CCR_NOT_VERSION_2 Der Partner unterst tzt die Version 2 des CCR Protokolls nicht 26 SESSION_NO_FDX Die Session Funktionalit t Full Duplex ist nicht gesetzt 27 SESSION_NO_DATA_SEPARATION Die Session Funktionalit t Data Separation ist nicht gesetzt obwohl CCR im Kontext ist 28 SESSION_NO_TYPED_DATA Die Session Funktionalit t Typed Data ist nicht gesetzt obwohl CCR im Kontext ist 29 SESSION_NO_MINOR_SYNCHRONIZE Die Session Funktionalit t Minor Synchronize ist nicht gesetzt obwohl CCR im Kontext ist 30 SESSION_NO_RESYNCHRONIZE Die Session Funktionalit t Resynchronize ist nicht gesetzt obwohl CCR im Kontext ist 31 TOKEN_CONTENTION_WINNER_AND_NO_TOKEN Die lokale Anwendung ist Contention Winner aber nicht im Besitz des Tokens nur wenn CCR im Kontext ist 32 TOKEN_CONTENTION_LOSER_AND_TOKEN Die lokale Anwendung ist Contention Loser aber im Besitz des Tokens nur wenn CCR im Kontext ist 33 INITIAL_SYNC_POINT_SERIAL_NUMBER_NOT_SET Die Initial Syncpoint Serial Number ist nicht gesetzt obwohl CCR
315. n hat so wird der I O PCB benutzt Im anderen Fall wird ein alternate PCB benutzt bei dem vorher mit dem Aufruf CHNG eine neue Zieladresse gesetzt wird Der Transaktionscode wird vor die Nachricht gesetzt oder ber einen MOD Namen message output description im MFS message format service definiert Vergleich mit KDCS Aufrufen Die Aufrufe GU und GN auf den IOPCB entsprechen den KDCS Aufrufen MGET FGET Der Aufruf GN liefert eine Anzeige die aussagt ob weitere Nachrichten Teile vorhan den sind Eine Folge von MPUT FPUT NT und MPUT FPUT NE muss von IMS mit GU und GN gelesen werden Der Aufruf ISRT entspricht den KDCS Aufrufen MPUT IOPCB und FPUT alternate PCB Der Aufruf ROLL entspricht dem KDCS Aufruf PEND FR Der Aufruf ROLLB entspricht dem KDCS Aufruf PEND RS Programmende impliziert eine Sicherungspunkt Anforderung und entspricht PEND FI U5461 J Z135 6 245 IMS Programmierung bei Kopplung mit openUTM openUTM IMS Kopplung ber LU6 1 7 4 4 Beispiele f r die openUTM IMS Kommunikation 1 Start eines IMS Auftrags aus einem UTM Anwendungsprogramm gt INIT MGET Client APRO DM KCPI gt A MPUT NE KCRN gt A PEND KP FMH5 Daten gt GU IO PCB ISRT RETURN lt Daten SRQ INIT MGET NT KCRN gt A MPUT NE Client PEND FI sE SRSP gt 2 Dasselbe jedoch mit PEND RE im UTM Anwendungsprogramm gt INIT MGET Client APRO
316. n k nnen Dies sollte von den Verwaltern der beteiligten Datenbanken gepr ft werden Log Name Fehler beim Wiederaufsetzen einer Transaktion TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Evtl muss openUTM LU62 kalt gestartet werden Eine Transaktion wurde wegen eines Verbindungsverlustes auf der LU6 2 Seite in der Commit Phase unterbrochen Beim Resynchronisieren mit dem LU6 2 Partner trat ein Fehler auf Der LU6 2 Partner akzeptiert den von openUTM LU62 vorge schlagenen Log Name nicht Ursache ist vermutlich ein Kaltstart von openUTM LU62 oder des LU6 2 Partners oder ein CEMT SET CONNECTION NOTPENDIG bei CICS Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 Wenn die Ursache in einem Kaltstart des LU6 2 Partners liegt sollte gepr ft wer den ob ein Zur ckgehen auf den vorherigen Anwendungslauf m glich ist d h ob sich der Kaltstart r cksetzen l sst Wenn dies nicht m glich ist muss die openUTM LU62 Instanz beendet und kalt gestartet werden Wenn die Ursache in einem Kaltstart von openUTM LU62 liegt muss auch der LU6 2 Partner einen Kaltstart durchf hren Bei CICS erreicht man dies z B durch das Kommando CEMT SET CONNECTION NOTPENDING Es ist jedoch zu beachten dass durch diese manuellen Eingriffe eventuell Daten bank Inkonsistenz
317. n nicht beschrieben sind k nnen diese Pseudo Dialoge auch in UTM Anwendungen verwendet werden und zwar bei Kopplungen openUTM IMS und open UTM CICS Bei LU 6 1 erfolgt die Adressierung von Asynchron Vorg ngen im Prinzip mit dem SCHEDULER Function Management Header FMH6 Dabei sind folgende Felder von Bedeutung DPN Destination Process Name Transaktionscode in der Auftragnehmer Anwendung openUTM CICS Name eines Editors der die Nachricht auswertet oder ein Formatname in der Auftragnehmer Anwendung IMS PRN Primary Resource Name Transaktionscode bzw LTERM Name in der Auftragnehmer Anwendung IMS LTERM Name in der Auftragnehmer Anwendung CICS RDPN Return Destination Process Name DPN in der lokalen Anwendung RPRN Return Primary Resource Name PRN in der lokalen Anwendung Die Felder RDPN RPRN im FMH6 k nnen benutzt werden um einen Pseudodialog zwischen Asynchron Vorg ngen zu f hren Ein Auftraggeber sendet eine Nachricht mit RDPN RPRN an einen asynchronen Auftragnehmer Vorgang der das Ergebnis an den durch RDPN RPRN spezifizierten Asynchron Vorgang in der Auftraggeber Anwendung sendet U5461 J Z135 6 249 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen Bei CICS k nnen die Felder RDPN RPRN mit den Parametern RTRANSID RTERMID beim START Kommando belegt werden Mit dem RETRIEVE Kommandb erh lt ein CICS An wendungsprogramm in RTRANSID RTERMID die Werte von RDPN RPRN aus dem Einga be F
318. n sind sind REM APT und REM AEQ Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Codierung des Application Context Name fehlerhaft openUTM LU62 hat vom OSI TP Partner eine TP_BEGIN_DIALOGUE indication mit einem fehlerhaft codierten Application Context Name was zur Ablehnung des OSI TP Dialogwunsches f hrt Diese Meldung kann nur auftreten bei einem OSI TP Partner der keine UTM Anwendung ist Warnung Application Context Name nicht konfiguriert Dialogwunsch fuer TP amp TPNAME wird trotzdem akzeptiert openUTM LU62 hat vom OSI TP Partner d h von der UTM Anwendung eine TP_BEGIN_DIALOGUE indication mit einem Application Context Name empfan gen der nicht mit der Generierung von openUTM LU62 bereinstimmt Dieser Feh ler wird als nicht besonders schwerwiegend angesehen so dass es trotzdem zum Aufbau einer Conversation zum LU6 2 Partner kommt Allerdings sollte der openUTM LU62 Generierungsparameter APPL CONTEXT entsprechend ange passt werden Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Presentation Context Identifier nicht ermittelbar Der Presentation Context Identifier ist eine Gr e die das Paar abstrakte Syntax Transfersyntax innerhalb des Application Contexts eindeutig beschreibt und f r die Codierung und Decodierung von Nutz und Security Daten ben tigt wird Diese Gr e wird nach dem Empfang einer TP_BEGIN_DIALOGUE indication ermitte
319. n will Write in Output Pipe zu Prozess mit PID amp PID liefert Fehler ENOBUFS Beim Schreiben einer Quittung an ein Administrationsprogramm oder eines Auftrags an den Write Log D mon u62_wlog mit der Systemfunktion write ist der Fehler errno ENOBUFS aufgetreten u62_tp wiederholt nach einer Wartezeit von einer 1 4 Sekunde den Schreibversuch gibt aber bei einem erneuten Auftreten die ses Fehlers keine Meldung mehr aus Tritt dieser Fehler 10 mal unmittelbar hintereinander auf so verwirft u62_tp einfach die interne Nachricht Das Administrationsprogramm w rde dann eine Zeit ber schreitung beim Warten auf die Quittung melden H uft sich der Fehler so dass er inzwischen mehr als 60 mal insgesamt aufgetreten ist so beendet sich u62_tp abnormal Die Output Pipe zum Prozess mit PID amp PID ist voll Das System kann im Moment berhaupt keine Daten in die Named Pipe zum Ad ministrationsprogramm oder zum Write Log D mon mit der PID amp PID schreiben Da die internen Nachrichten von openUTM LU62 relativ kurz sind und von den ein zelnen Programmen auch sofort aus ihren Eingabe Pipes ausgelesen werden soll te diese Meldung nicht erscheinen u62_tp wiederholt hnlich wie beim Fehler ENOBUFS nach einer 1 4 Sekunde die Schreiboperation und verwirft nach 20 er folglosen Versuchen die Nachricht 278 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des Programms u62_tp 054 055 056 057 058 060 06
320. nced Communications Function Association Control Service Element Application Entity Application Entity Qualifier Application Protocol Data Unit Advanced Program to Program Communication Appliction Process Title American Standard Code for Information Interchange Begin Bracket Basic Communication Access Method Commitment Concurrency and Recovery Change Direction Conditional End Bracket Customer Information Control System Communication Manager in UNIX Common Programming Interface for Communication Common Programming Interface for Resource Recovery Distributed Program Link Destination Process Name Define Response Indicator Distributed Transaction Processing End Bracket Extended Binary Coded Decimal Interchange Code External Call Interface Enciphered Data Indicator Exec Interface Block U5461 J Z135 6 373 Abk rzungen ERI ESA ET FDDI FID FMH FSM GDS IMS ISC ISO KDCS LU LUW LUWID MFS MPTN MVS NCP OSI OSI TP OSS PCMX PDI PDN PET PID PIP PLU PRN QRI RACF RDO Exception Response Indicator Enterprise System Architecture End of Transaction Fiber Distributed Data Interface Format Identifier Function Management Header Finite State Machine General Data Stream Information Management System Intersystem Communication International Organization for Standardization Kompatible Datenkommunikationsschnittstelle Logical Unit Logical Unit of Work Logical Unit of Word Identifier
321. nde 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 Der klassische Anwendungsserver openUTM bietet eine Ablaufumgebung die allen diesen Anforderungen moderner unternehmenskritischer Anwendungen gewachsen ist denn openUTM verbindet alle Standards und Vorteile von Transaktionsmonitor Middleware 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 U5461 J Z135 6 11 Einleitung openUTM ist Teil des umfassenden Angebots von openSEAS Im Rahmen des Produktan gebots openSEAS Open Suite for Enterprise Application Servers nutzen innovative Pro dukte die ausgereifte Technologie von openUTM BeanConnect ist eine Familie von Adaptern gem der Java Connector Architecture JCA von Sun und bietet den standardisierten Anschluss von UTM Anwendungen an J2EE Application Server insbesondere an Oracle AS 10g Oracle AS 10g ist der Appli cation Server der als Bestandteil von openSEAS als Entwicklungs und Ablaufplattform aller Gesch ftsanwendungen Portale und Web Seiten im Grid Computing Ma stab zur Verf gung steht WebTransactions
322. nfirm sind neben Nettodaten und Fehlermeldungen auch einfache Quittungen zul ssig Dies entspricht bei open UTM KCOF H beim APRO Bei Sync Level 2 Syncpoint ist die volle Transaktionssicherheit f r verteilte Transaktionen eingeschaltet Dies entspricht bei openUTM KCOF C beim APRO Sync Point Synchronization point Stelle innerhalb eines Ablaufs einer verteilten Verarbeitung an der die gemein samen Ressourcen in einen definierten Zustand gebracht werden Bei openUTM verwendet man statt dessen den Begriff Transaktionsende oder Sicherungspunkt Systems Network Architecture SNA SNA ist die Bezeichnung f r eine Reihe von IBM definierten Kommunikations protokollen System Services Control Point SSCP Adressierbare SNA Instanz in einem Typ 5 Knoten Der SSCP verwaltet die Verbin dungen zu allen Typ 4 und Typ 2 0 Knoten in seinem Netz und alle Sessions zwi schen dem Typ 5 Knoten und einem dieser untergeordneten Knoten U5461 J Z135 6 369 Fachw rter Transaction Program TP Im IBM Sprachgebrauch bezeichnet man jedes Programm das eine Pro gramm Programm Kommunikation zu anderen Programmen im Netz betreibt als Transaction Program und zwar unabh ngig davon ob eine echte verteilte Transaktionsverarbeitung stattfindet oder nicht Erfolgt die Programm Pro gramm Kommunikation ber LU6 2 so wird jedes Transaction Program durch einen TP Namen identifiziert Dieser TP Name entspricht dem Transaktions code von open UTM od
323. nformationen bestehen aus IP Adressen Port Nummern und T Selektoren Siehe auch weiter unten das vollst ndige Generierungsbeispiel 4 1 8 openUTM Generierung Aus Sicht von openUTM muss eine LU6 2 Kopplung genauso wie eine OSI TP Kopplung generiert werden Sie sollten dabei allerdings ber cksichtigen dass pro Access Point ma ximal 254 Verbindungen ber openUTM LU62 aufgebaut werden k nnen Dies bedeutet dass bei einer LU6 2 Verbindung der Wert des ASSOCIATIONS Parameters in der OSI LPAP Anweisung nicht gr er als 254 sein sollte 4 1 9 Definieren von CICS Transaktionen Lokale Transaktionen werden ber RDO bei CICS wie folgt definiert DEFINE TRANSACTION transaction_code GROUP group_name PROGRAM program_name INDOUBT WAIT Die Operanden haben folgenden Bedeutung TRANSACTION transaction_code 1 4 Zeichen langer Transaktionscode f r die CICS Transaktion Der Name muss im Feld KCRN beim UTM Aufruf APRO angegeben werden GROUP group_name 1 8 Zeichen langer Name Der CICS Systemverwalter muss diesen Namen verge ben Er kommt nur in den CICS Definitionen vor PROGRAM program_name Name des CICS Programms INDOUBT WAIT Diese Angabe ist notwendig um nach Sessionfehlern eine ordnungsgemaBe Synchronisation mit openUTM zu erreichen U5461 J Z135 6 81 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 4 1 10 Ferne Transaktionen m ssen in CICS nicht definiert werden Der Transaktionscode wird wie
324. ng ist nur im Zusammenhang mit den Schaltern cs ds und as m glich also mit Kommandos die in u62_tp die LU6 2 Schnittstelle zur LU6 2 Ba sis Software z B TRANSIT betreffen Sie zeigt im Falle von TRANSIT an dass die lokale LU der Instanz von openUTM LU62 Generierungsparameter LOC LU ALIAS oder die ferne LU Generierungsparameter REM LU ALIAS nicht in der TRANSIT Konfigurierung enthalten ist oder dass es in der TRANSIT Generie rung keine geeignete PAIR Anweisung gibt so dass keine Kommunikation zwi schen den beiden LUs m glich ist Instanz amp INST Systemfehler aufgetreten Ein Administrationskommando konnte aufgrund nicht n her beschriebener Gr nde nicht ausgef hrt werden Betrifft das Administrationskommando die LU6 2 Schnitt stelle von openUTM LU62 cs ds as so ist eine m gliche Ursache dass die LU6 2 Basis Software also bei TRANSIT das TRANSIT Grundsystem oder der LU62Mgp nicht aktiv ist Beim Kommando cs kann es auch sein dass das Partner system den Sessionaufbau abgelehnt hat Instanz amp INST beendet sich Instanz amp INST Einschalten der Traces erfolgreich Instanz amp INST Die Traces sind bereits eingeschaltet U5461 J Z135 6 351 Meldungen von u62_adm Meldungen von openUTM LU62 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 50 Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz amp INST Instanz
325. ngen von open UTM LU62 Meldungen des Programms u62_tp 003 004 006 007 008 009 010 011 012 Wechsel ins Basis Directory amp DIRNAME nicht moeglich errno amp ERRNO amp ERRTEXT Das Programm u62_tp kann nicht in das Arbeitsverzeichnis amp DIRNAME wechseln Die genauere Ursache wird durch den Inhalt der Systemvariablen errno amp ERRNO angegeben amp ERRTEXT enth lt einen kurzen Text der den Fehler genauer be schreibt Fehler bei Signalbehandlung errno amp ERRNO amp ERRTEXT Es ist ein interner Fehler bei der Initialisierung der Signalbehandlung aufgetreten Der Inhalt der Systemvariablen errno amp ERRNO und der kurze Text in amp ERRTEXT geben genaueren Aufschluss ber die Fehlerursache Die Konfigurationsdatei amp FILENAME kann nicht geoeffnet werden errno amp ERRNO amp ERRTEXT Fehler beim Einlesen der Konfigurationsdatei amp FILENAME errno amp ERRNO amp ERRTEXT Die Version von u62_tp stimmt nicht mit der Konfigurationsdatei amp FILENAME ueberein amp VERS1 statt amp VERS2 Die vom Generierungsprogramm u62_gen erzeugte Konfigurationsdatei amp FILENAME enth lt eine falsche Versionsnummer Entweder handelt es sich bei amp FILENAME um gar keine Konfigurationsdatei oder es wurde eine inkompatible Version von u62_gen zur Generierung verwendet Der lokale LU Name amp LUNAME ist nicht konfiguriert Die lokale LU amp LUNAME f r die die Instanz gestartet wurde Schalter I
326. ngetragen zu werden Kommentare werden durch ein Zeichen eingeleitet und reichen bis zum Zeilenende Wenn diese Datei keinen einzigen Eintrag enth lt oder nicht vorhanden ist sind alle Benut zer administrationsberechtigt Administration unter Windows Systemen Unter Windows Systemen empfiehlt es sich mit Start gt Programme gt openUTM LU62 gt Kommando Eingabe eine DOS Shell zu erzeugen Unter dieser DOS Shell k nnen dann die im folgenden beschriebenen Kommandos ohne den Vorspann opt 1ib utm1u62 auf gerufen werden 54 U5461 J Z135 6 LU6 2 Koppl ungen mit openUTM LU62 openUTM LU62 administrieren 3 3 2 openUTM LU62 starten Mit u62_start wird openUTM LU62 als Hintergrundprozess gestartet Aufrufsyntax opt 1ib utml u62 u62_start 1 loc_lu_alias_name L ton trace_optionen cE c k J Beschreibung loc_lu_alias_name Wenn der Schalter I nicht angegeben ist ermittelt u62_start anhand der Konfigurationsdatei eine Liste aller open UTM LU62 Instanzen und startet alle diese Instanzen Ist der Schalter I angegeben so wird nur die zur LU loc_lu_alias_name geh rende Instanz gestartet loc_lu_alias_name muss einem Namen aus der openUTM LU62 Konfigurierung entsprechen ton trace_optionen Trace on Der Trace wird eingeschaltet Die Ausf hrlichkeit des Trace kann durch trace_optionen gesteuert werden Bei trace_optionen kann angegeben werden ob und mit welcher Ausf hrlich
327. nicht mehr ben tigt Neue Startoption die als Mittelweg zwischen Kaltstart und Warmstart fungiert u62_start k Neue Option bei der Statusanzeige die den Zustand der Enterprise Extender Verbin dungen anzeigt u62_sta c 20 U5461 J Z135 6 Einleitung Metasyntax 1 4 Metasyntax Die in diesem Handbuch verwendete Metasyntax ist dieselbe wie in den Vorgangerhand b chern GROSSBUCHSTABEN In Gro buchstaben sind die Namen von Aufrufen Anweisungen Kommandos und Operanden dargestellt kleinbuchstaben In Kleinbuchstaben sind die Platzhalter f r Operandenwerte dargestellt In eckigen Klammern stehen wahlfreie Angaben die entfallen k nnen In geschweiften Klammern stehen alternative Angaben von denen Sie eine ausw hlen m ssen Unterstreichung Unterstreichung kennzeichnet den Standardwert Schreibmaschinenschrift In Schreibmaschinenschrift im Flie text werden Kommandos Dateinamen Meldungen und Beispiele ausgezeichnet die in genau dieser Form eingegeben werden m ssen bzw die genau diesen Namen oder diese Form besitzen Kursiv Kursivschrift im Flie text kennzeichnet Variablen U5461 J Z135 6 21 22 U5461 J Z135 6 2 Kopplung mit IBM Systemen Bei IBM Systemen ist verteilte Transaktionsverarbeitung blicherweise mit dem SNA Pro tokoll LU6 2 realisiert Folgende IBM Transaktionsmonitore und Kommunikationsprodukte unterst tzen dieses Protokoll CICS bzw CICS Tran
328. nition in VTAMLST AOIMS AOIMS VBUILD TYPE APPL APPLICATION MAJOR NODE IMSA APPL ACBNAME IMSA ACBNAME MUST BE EQ LABEL PPC YES INLOSS ALL OSES 0 AINL NALLONW GMOD APPCHOST WNL 5 WNR 5 PL NALLOW LIM 10 T 19 ESS YES CPT NONE RBEXIT YES YNCLVL SYNCPT PACING 1 ij DO G Te D SS Oc N m gt MADUMMHHODWD Ha gt unmuwno NNN Tr MODE Definition in VTAM SOURCE ISTINCLM ISTINCLM MODETAB APPCHOST MODEENT LOGMODE APPCHOST RUSIZES X 8989 4096 SRCVPAC X 00 SSNDPAC X 01 OQ QAO END DEI EI OO Ga ea 186 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung generieren IBM Communications Server NODE PORT ANYNET_SUPPORT NONE CP_ALTAS MHPBO2GC DEFAULT_PREFERENCE NATIVE DISCOVERY_SUPPORT DISCOVERY_SERVER DLUR_SUPPORT NORMAL FQ_CP_NAME P390 MHPBO2GC AX_LOCATES 150 AX_LS_EXCEPTION_EVENTS 200 ODE_ID 05D25129 ODE_TYPE NETWORK_NODE REGISTER_WITH_CDS 1 REGISTER_WITH_NN NONE SEND_TERM_SELF 0 TP_SECURITY_BEHAVIOR VERIFY_EVEN_IF_NOT_DEFINED ACTIVATION DELAY_TIMER 30 ALLOW_ABM_XID_MISMATCH 0 DELAY_APPLICATION_RETRIES 1 DLC_NAME IBMEEDLC IMPLICIT_BRANCH_EXTENDER_LINK 0 IMPLICIT_CP_CP_SESS_SUPPORT 1 IMPLICIT_DEACT_TIMER 600 IMPLICIT_DSPU_SERVICES NONE IMPLICIT_HPR_SUPPORT 1 IMPLICIT_LIMITED_RESOURCE NO IMPLICIT_LINK_LVL_ERROR 0 LINK_STATION_ROLE NEGOTIABLE MAX_ACTIVATION_ATTEMPTS 0 MAX_IFRM_RCVD 8 MAX
329. nkommenden Conversation kann beim CICS API mittels EXTRACT PROCESS erfragt werden 120 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 4 2 4 Vergleich mit KDCS Aufrufen Im folgenden soll versucht werden die CICS Kommandos in ihrer Semantik mit KDCS Auf rufen zu vergleichen Adressierung eines fernen Vorgangs mit Transaktionssicherung ALLOCATE APRO DM AM KCOF C CONNECT PROCESS SYNCLEVEL 2 Adressierung eines fernen Vorgangs ohne Transaktionssicherung ALLOCATE APRO DM KCOF H CONNECT PROCESS SYNCLEVEL 1 bzw ALLOCATE APRO DM AM KCOF B CONNECT PROCESS SYNCLEVEL O Nachrichtenaustausch ohne Sicherungspunkt SEND INVITE WAIT MPUT NE KCRN gt RECEIVE PEND KP INIT MGET KCRN gt Senden einer Nachricht und Anforderung zum Transaktionsende SEND MPUT NE KCRN gt SYNCPOINT CTRL PR KCRN gt PEND KP INIT MGET NT KCRN gt Senden einer Nachricht und Anforderung Transaktions und Vorgangsende SEND LAST MPUT NE KCRN gt SYNCPOINT CTRL PE KCRN gt PEND KP INIT MGET NT KCRN gt U5461 J Z135 6 121 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 Nachrichtenaustausch und Anforderung zum Transaktionsende SEND INVITE MPUT NE KCRN gt SYNCPOINT PEND RE RECEIVE INIT MGET NT KCRN gt Rucksetzen der Transaktion SYNCPOIN
330. nn der aktive Aufbau einer Association abge lehnt wird weil die Best tigung des Partners nicht akzeptiert werden kann Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPRICT siehe Tabellle auf Seite 337 amp XPLTH eventuell eine fehlerhafte Lange Assoziation abgelehnt a_asscf amp ACPNT amp OSLPAP Grund Partner unbekannt Partner Adresse amp PARTADDR amp XASSREF Diese Meldung wird ausgegeben wenn der aktive Aufbau einer Association abge lehnt wird weil der ferne Partner bei der Bestatigung des Associationsaufbaus mit einer Adresse amp XPADDR antwortet die in der lokalen Anwendung nicht bekannt ist Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp PARTADDR Tats chliche Adresse des Partners amp XASSREF XAPTP interne Referenz der Assoziation U5461 J Z135 6 319 Meldungen des XAP TP Providers Meldungen von openUTM LU62 P011 P012 Assoziation abgelehnt a_asscf amp ACPNT amp OSLPAP Grund Falscher Application Context Name amp XPOOBID amp XP1OBID amp XP2OBID amp XP30BID amp XP4OBID amp XP5OBID amp XP6OBID amp XP7OBID amp XP8OBID XP9OBID Diese Meldung wird ausgegeben wenn der aktive Aufbau einer Association abge lehnt wird weil der ferne Partner bei der Bestatig
331. nt Deallocate Daten CEB gt MGET NT VGST C KCRN A Dieses Beispiel entspricht dem Beispiel 20 im Abschnitt Beispiele fur openUTM CPI C Kommunikation auf Seite 154 Synchroner Aufruf eines IMS CPI C Programms von openUTM mit Transaktionssiche rung IMS Anwendung UTM Anwendung APRO DM KCOF C KCPI A MPUT NE KCRN A PEND KP lt FMH5 Daten Accept Receive DATA Receive SEND Send_Data Prep_To_Rcv Daten gt MGET NT KCRN A VGST 0 U5461 J Z135 6 203 openUTM IMS Kopplung programmieren openUTM IMS Kopplung ber LU6 2 IMS Anwendung UTM Anwendung PEND FI lt Prepare Receive SYNCP DEAL SRRCMIT Req Commit gt UTM Systemcode lt Committed PEND FI Dieses Beispiel entspricht dem Beispiel 12 im Abschnitt Beispiele f r openUTM CPI C Kommunikation auf Seite 154 Dort finden Sie weitere Beispiele 5 2 7 Ablauf Beispiele mit Standard IMS Transaktionen 1 Synchroner Aufruf eines IMS Kommandos von openUTM z B DISPLAY APPC IMS Command UTM Anwendung APRO DM KCOF B DISPLAY KCRN A MPUT NE APPC KCRN A PEND KP lt FMH5 Daten DISPLAY APPC Ausgabe Daten CEB gt MGET NT VGST C KCRN A Bemerkung Mit dem Kommando DISPLAY APPC kann man sich den Zustand aller APPC Ressourcen ausgeben lassen 204 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren 2 Asynchron
332. nwendungsprogramm be n tigt und mit Transaktionssicherung CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND CMDEAL SRRCMIT RR_OK FMH5 Daten RequestCommit gt INIT PU ENDI MGET VGST PEND FI lt Committed A F SEND N 0 TAST P 154 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 3 Zwei Transaktionen in einem Vorgang erste Variante CMINIT CMSSL CM_SYNC_POINT CMALLC CMSST CM_SEND_AND_PREP_TO_RECEIVE CMSEND SRRCMIT FMH5 Daten RequestCommit gt INIT PU ENDTA C SEND Y MGET VGST 0 TAST P MPUT NE PEND RE lt Committed Daten RR_OK CMDEAL SRRCMIT Daten RequestCommit gt INIT PU ENDTA F SEND N MGET VGST 0 TAST P PEND FI lt Committed RR_OK U5461 J Z135 6 155 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 4 Zwei Transaktionen in einem Vorgang zweite Variante CMINIT CMSSL CM_SYNC_POINT CMALLC CMSEND CMRCV CM_OK SRRCMIT RR_OK CMSEND CMDEAL SRRCMIT RR_OK FMH5 Daten INIT MGET MPUT PEND RequestCommit gt Committed Daten INIT MGET PEND RequestCommit gt Committed INIT MGET PEND PU NE KP PU RE PU FI ENDTA 0 SEND Y VGST 0 TAST 0 ENDTA R SEND N VGST 0 TAST P ENDI V6S1 A F SEND N 0 TAST P 156 U5461 J Z1
333. o hat folgende Syntax EXEC CICS SEND LATTACHID name FROM bereich LENGTH bereich LINVITE LAST Die Nachricht ist f r den Auftraggeber principal facility bestimmt Der Operand INVITE veranlasst explizit dass mit dem Senden der Nachricht das Sende recht change direction an den Partner bertragen wird Der Dialog wird dabei weiterge f hrt openUTM muss darauf mit MGET MPUT reagieren kein PEND FI Werden vom CICS Anwendungsprogramm Daten gesendet die l nger als die generierte RU Size sind so kommen diese beim UTM Anwendungsprogramm in mehreren Teilnach richten an Soll das vermieden werden so muss beim SEND der Parameter ATTACHID angegeben werden der sich auf ein vorheriges BUILD ATTACH bezieht In diesem BUILD ATTACH kann dann das Nachrichtenformat definiert werden 228 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r CICS Auftragnehmer Vorg nge CONVERSE Das CONVERSE Kommando wird verwendet um eine Nachricht an den Partner zu senden mit gleichzeitigem Warten auf die Antwort Dieses Kommando hat dieselbe Wirkung wie die Kommandofolge SEND INVITE RECEIVE Das Kommando hat folgende Syntax EXEC CICS CONVERSE FROM bereich FROMLENGTH bereich LATTACHID name INTO bereich SET pntr TOLENGTH bereich LMAXLENGTH bereich LNOTRUNCATE SYNCPOINT Siehe Seite 226 RETURN Das Kommando RETURN in einem CICS Auftragnehmer Vorgang impliziert das Senden noch nicht g
334. onspartner der den anderen Partner zum Sync Point Transaktionsende auffordert Kaltstart cold start Start Typ einer transaktionsgesicherten Anwendung bei dem alle Log Records gel scht werden und somit das Ged chtnis ber unvollst ndige Transaktionen verloren geht 364 U5461 J Z135 6 Fachw rter Logical Unit LU Unter einer logical unit versteht man einen adressierbaren Kommunikations partner in einem SNA Netz Eine LU verwaltet eine oder mehrere Kommunikati onsbeziehungen Sessions zu anderen LUs Terminals openUTM CICS und IMS Anwendungen Ob nur eine oder mehrere Kommunikationsbeziehungen m glich sind h ngt ab vom Typ der physical unit und vom Typ der LU independent dependent LU Eine LU in einem Typ 2 0 Knoten kann immer nur eine Session zu einer anderen LU aufbauen und zwar immer nur mit demselben SNA Protokoll Je nachdem um welches Protokoll es sich dabei handelt z B LU2 LU6 1 oder LU6 2 bezeichnet man deshalb auch die LUs als LUs vom Typ LU2 LU6 1 oder LU6 2 Jede LU ist im SNA Netz unter einem eindeutigen maximal 8 Zeichen langen Namen dem sogenannten LU Namen bekannt Bei independent LU6 2 wird dem achtstelligen LU Namen noch eine ebenfalls achtstellige Netzidentifikation vorangestellt Beides zusammen bildet dann den sogenannten vollqualifizierten Netzwerknamen der LU Bei dependent LUs in einem Typ 2 0 Knoten erfolgt die Adressierung nicht ber den LU Namen sondern ber eine sogenannte Lo
335. ontention Winner Contention Loser Einer der beiden Kommunikationspartner einer Session wird zum Contention Winner erkl rt der andere zum Contention Loser Der Contention Winner darf Brackets autonom er ffnen Der Contention Loser muss beim Contention Win ner die Erlaubnis zur Er ffnung einer Bracket einholen Der Contention Winner wird manchmal auch first speaker genannt der Contention Loser manchmal auch bidder Conversation Logische Verbindung zwischen zwei Transaktionsprogrammen ber eine LU6 2 Session Eine Conversation beginnt mit dem Allocate entspricht APRO bei openUTM und endet mit dem Deallocate Eine Conversation belegt ber ihre gesamte Lebensdauer eine Session und sperrt sie damit f r andere Benutzer Zum Belegen der Session wird das Bracket Protokoll benutzt Customer Information Control System CICS TransaktionsmonitoworlBMEisirdeiFunktionalit vergleichbadenppenUTMCICS gibt es auf verschiedenen Plattformen z B CICS Transaction Server for z OS f r das Betriebssystem z OS CICS for iSeries f r das Betriebssystem i5 OS fr her OS 400 TXSeries for Multiplatforms f r die Betriebssysteme AIX Sola ris HP UX Windows U5461 J Z135 6 361 Fachw rter Data Language 1 DL I Von IBM definierte Programmschnittstelle fur Datenbankzugriffe und Daten kommunikation DL I wird ausschlie lich in IMS benutzt Mit DL I ist eine Kom munikation zwischen IMS und openUTM m glich Dependent LU Siehe independ
336. openUTM V5 3 openUTM LU62 V5 1 Verteilte Transaktionsverarbeitung zwischen openUTM und CICS IMS und LU6 2 Anwendungen Ausgabe Juli 2008 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 2000 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 2000 erf llt cognitas Gesellschaft f r Technik Dokumentation mbH www cognitas de Copyright und Handelsmarken Copyright Fujitsu Technology Solutions GmbH 2009 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 2 1 122 1 2 3 1 3 1 4 2 1 2 2 2 3 2 4 2 5 2 6 2 7 2 8 2 9 2 10 Einleitung 22 2425 468 an a an a a a a a in 11 Konzept und Zielgruppen dieses Handbuchs 2 22 2 0 13 Wegweiser durch die Dokumentation zu openUTM 2 55 14 openUTM Dokumeniati n 2 4 4 8 262 a See eet ar en a 14 Dokumentation zum op
337. orrangdaten nicht zugelassen abgebaut 480 T_RLNOPERM Die Administration des lokalen CCP hat den Verbindungsaufbau verhindert 481 T_RLPERMLOST Die Administration des lokalen CCP hat die Verbindung abgebaut 482 T_RLNOCONN Weil keine Netzverbindung verf gbar ist konnte das lokale CCP den Verbindungs aufbau nicht durchf hren 483 T_RLCONNLOST Das lokale CCP hat die Verbindung wegen Verlust der Netzverbindung abgebaut H ufigste Ursache Generierungsfehler auf CCP und PDN Seite z B unstimmi ge Link Adressen Als Problemursache kommen au erdem in Frage Partner ist nicht vorhanden Modem ist defekt oder falsch eingestellt DU Anschluss ist nicht gesteckt DF Board defekt 484 T_RLNORESP Weil der Partner nicht auf den CONRQ antwortet kann das lokale CCP die Verbin dung nicht aufbauen 485 T_RLIDLETRAF Das lokale CCP hat die Verbindung wegen Verbindungsverlust Idle Traffic Timeout abgebaut 486 T_RLRESYNC Das lokale CCP hat die Verbindung abgebaut weil die Resynchronisierung mehr als zehn Wiederholungen erfolglos war 487 T_RLEXLOST Das lokale CCP hat die Verbindung abgebaut weil der Vorrangdatenkanal defekt ist mehr als drei Wiederholungen 326 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des XAP TP Providers XPINI Bedeutung 403 O_LOC_SESS Der Versursacher ist der lokale Session Provider amp XP1INFO kann folgende Werte annehmen 4 S_PROTERROR
338. ows System e Kopplung zwischen IBM Host und Windows System mittels Enterprise Extender Die Dateinamen der IMS und VTAM Definitionen sind als Beispiel anzusehen und k nnen in echten Einsatzf llen anders gew hlt sein U5461 J Z135 6 183 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 IMS Definitionen IMS Systemdefinitionen in IMS CNTL STAGE1 STAGE1 SYSPRINT SYSLIB SYSPUNCH SYSUT1 SYSUT2 SYSUT3 SYSIN AP DD AP RANSAC RANSAC END TP_Profile Definition in IMS CNTL APPCTP SYSPRINT SYSSDLIB SYSSDOUT SYSIN TPADD S A XX TPSCHED_EX YSTEM CTIVECYES CLASS 1 MAXRGN 1 R C EXEC PGM ASMA90 PARM NOOBJ DECK REGION 0M DD SYSOUT DD DISP SHR DSN IMS810 ADFSMAC DD DISP SHR DSN USER IMS CNTL STAGE2 DD UNIT 3390 SPACE CYL 05 05 DCB OPTCD C DD UNIT 3390 SPACE CYL 05 05 DCB OP1 DD UNIT 3390 SPACE CYL 05 05 DCB OP1 PLCTN GPSB TESTIMS1 PGMTYPE TP CODE IMS1 MSGTYPE NONRESPONSE INQUIRY NO MODE SNGL PLCTN GPSB IMSTACO PGMTYPE TP CODE IMSO MSGTYPE RESPONSE INQUIRY NO MODE SNGL EXEC PGM ATBSDFMU DD SY SOUT DD DSN SYS1 APPCTP DISP SHR DD SY SOUT DD DATA DLM XX T DFSTPPEO PNAME IMSX TPSCHED_DELIMITER TRANCODE TESTIMSX ACF NONE PUT IME 0 184 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS
339. pplung direkt mit TRANSIT auf Solaris 33 ber TRANSIT Gateway 34 LU6 1 Protokoll 365 LU6 2 Anwendung 35 LU6 2 Edit Exit Routine 197 LU6 2 Kopplung 35 direkt ber IBM CS auf Solaris 27 direkt ber SNAP IX auf Solaris 26 direkt ber SNAP IX auf Windows Systemen 28 direkt ber TRANSIT auf Solaris 25 mit IBM CS Gateway auf Linux AIX Systemen 31 mit IBM CS Gateway auf Windows Systemen 32 mit openUTM BS2000 OSD 29 mit SNAP IX Gateway auf Solaris 30 mit TRANSIT Gateway auf Solaris 29 LU6 2 Protokoll 365 LU6 2 TP Name IMS 179 LU62 CODE 48 Lukewarm 56 LUW 365 LUWID 366 M Major Node Definition f r Enterprise Extender 186 Mapped Conversation 366 Meldungen 263 u62_tp 264 XAP TP Provider 316 Message Format Service 239 Metasyntax 21 Mode 366 MODE Definition IMS Beispiel f r LU6 2 186 Mode Name 48 120 366 MODENAME 48 MPTN 359 MPUT siehe KDCS Aufruf N Nachrichtenteile 234 NAME Makro 241 NCP 366 NETNAME 76 210 NETNAMEQ 211 Netzwerkname 367 0 openUTM CICS Kopplung 75 209 249 openUTM IMS Kopplung 237 249 openUTM LU62 35 Installationsverzeichnis 39 Instanz 36 Kopplungsbeispiel 29 Prozess 38 openUTM LU62 Generierung mit TNSX 89 ohne TNSX 89 91 openUTM LU62 Generierungbei Verwendung von TNSX IMS Beispiel f r LU6 2 191 openUTM LU62 Generierung ohne Verwendung von TNSX IMS Beispiel f r LU6 2 191 openUTM Programmierung bei LU6 2 150 CICS Kopplung ber LU6 1 234 IMS Kopplung 248 Pseudo
340. pte und Funktionen gibt Ihnen einen berblick ber die Leistungsf higkeit und Einsatzm glichkeiten des Produkts WebTransactions und informiert Sie ber dessen Eigenschaften und Funktionsweisen Das Handbuch erl utert das Objekt Konzept und den dynamischen Ablauf einer Web Transactions Sitzung e Im Handbuch WebTransactions Template Sprache sind alle Sprachmittel der Temp late Sprache WTML erl utert Es enth lt zahlreiche Beispiele die die Sprachmittel ver anschaulichen und Ihnen den Einsatz erleichtern e Die Handb cher WebTransactions Anschluss an open UTM Anwendungen ber UPIC und WebTransactions Anschluss an OSD Anwendungen beschreiben die not wendigen Schritte um UTM Dialog Anwendungen ber die UPIC bzw die Terminal Schnittstelle an das Web anzuschlie en An einem konkreten Beispiel werden diese Schritte nochmals verdeutlicht 18 U5461 J Z135 6 Einleitung Wegweiser durch die Dokumentation zu openUTM e Wenn Sie UTM Anwendungen und Services in Microsoft Anwendungen integrieren m chten dann steht Ihnen daf r die mit WebTransactions ausgelieferte Komponente BizTransactions mit dem Handbuch BizTransactions Anwendungsintegration mit Business Objekten zur Verf gung Es beschreibt neben der Installation und Konfigu ration auch die Konzepte und Komponenten von BizTransactions Au erdem wird die Administration und das Entwickeln von integrierten Client Anwendungen erl utert F r BizTransactions wird mit
341. r amp XPCTYPE lt 15 T_CMXCLASS CMX Klasse T_DSNOT_SPEC TNS Klasse nicht spezifiziert T_DSPAR_ERR TNS Parameterfehler T_DSILL_VERS Ung ltige TNS Version T_DSSYS_ERR TNS Systemfehler T_DSINT_ERR Interner TNS Fehler NO Oo PP Mm oO T_DSMESSAGE TNS Hinweis XPCVAL Bedeutung CMX Fehlerwert 0 T_NOERROR Kein Fehler 5 T_EIO Momentaner Engpass bzw Fehler im Transportsystem 14 T_EFAULT IO_Area nicht allokiert 100 T_UNSPECIFIED Nicht n her spezifizierter Fehler i a Fehler bei einem Systemaufruf 101 T_WSEQUENCE Unzul ssige Aufrufreihenfolge 103 T_WPARAMETER Ung ltiger Parameter 104 T_WAPPLICATION Die Anwendung ist im TNS nicht bekannt oder die Task ist zur Anmeldung der Anwendung nicht berechtigt oder die Anwendung ist von dieser Task bereits er ffnet 105 T_WAPP_LIMIT Der Grenzwert f r gleichzeitig aktive Anwendungen ist erreicht 106 T_WCONN_LIMIT Der Grenzwert f r gleichzeitig aktive Verbindungen ist erreicht 107 T_WTREF Ung ltige Transportreferenz oder Transportverbindung bereits abgebaut 111 T_NOCCP Das Transportsystem unterst tzt die gew nschte Anwendung oder Verbin dung nicht 114 T_CCP_END Das Transportsystem wurde beendet oder die Anwendung wurde vom Administrator geschlossen 255 T_WLIBVERSION Kein Anschluss an das CMX Subsystem m glich 100 T_INVREF Die evid ist ung ltig CM
342. r 29 Solaris mit SNAP IX 30 Solaris mit TRANSIT 29 Windows Systeme mit IBMCS 32 GDS 364 General Data Stream 364 Generieren von openUTM LU62 42 Generierungsbeispiel openUTM CICS ber LU6 1 und UNIX Systeme 215 openUTM CICS ber LU6 2 83 openUTM IMS Transaktionen 243 openUTM IMS ber LU6 1 und UNIX Systeme 242 Generierungsdatei 42 Aufbau 42 bearbeiten 52 Namen anzeigen 53 wiederherstellen 53 Generierungsprogramm 52 GN Aufruf siehe IMS Aufrufe GU Aufruf siehe IMS Aufrufe H Half Session 364 Host 364 IBM Communications Server 37 als Gateway auf Linux AlX Systemen 31 als Gateway auf Windows Systemen 32 Generierung LU6 2 Kopplung 80 93 IMS Beispiel f r LU6 2 187 Solaris 27 IMS 364 Administration ber LU6 2 208 LU Name bei LU6 2 178 LU6 2 TP Name 179 IMS Aufrufe AUTH LU6 2 194 CHNG LU6 1 245 CHNG LU6 2 194 CMD LU6 2 194 GCMD LU6 2 194 GN LU6 1 245 GN LU6 2 194 GU LU6 1 245 GU LU6 2 194 INOY LU6 2 195 ISRT LU6 1 245 ISRT LU6 2 194 PURG LU6 2 195 RETURN LU6 1 245 ROLB LU6 2 195 ROLL LU6 1 245 ROLL LU6 2 195 U5461 J Z135 6 397 Stichw rter ROLLB LU6 1 245 ROLS LU6 2 195 SETO LU6 2 195 SETS LU6 2 195 SETU LU6 2 195 SYNC LU6 2 195 IMS Definitionen bei LU6 2 184 IMS Generierung 237 243 IMS Programmierung 244 mit DL I f r LU6 2 194 Pseudo Dialog 256 Vergleich mit KDCS 245 IMS Programmierung CPI C f r LU6 2 197 IMS Startup
343. r Partner Application Entity wie er in der Generierungs datei mit REM AE angegeben wurde Wird kein TNSX verwendet T Selektor der Partner Anwendung ohne Formatangabe mit dem lokalen Port in Klammern Dahinter folgt der Host Name und falls noch Platz ist der TCP Port Beispiel REM_TSEL host 102 REM_TSELChost Ist der Host Name zu lang wird er abgeschnitten und mit darauf hinge wiesen REM_TSEL hostn Exchange Log Name Zustand Wenn Sync Level 2 vereinbart ist muss nach Neustart der openUTM LU62 Instanz oder nach einem Verbindungsabbruch ein Exchange Log Name zwischen openUTM LU62 und der LU6 2 Anwendung durchgef hrt werden Erst wenn das Exchange Log Name erfolgreich beendet wurde k nnen Transaktionen gestartet werden openUTM LU62 f hrt diesen Ex change Log Name selbst ndig aus Bei Fehlern kann jedoch ein manueller Eingriff notwendig sein Folgende Zust nde sind m glich Kein Exchange Log Name notwendig da Sync Level 2 nicht ver wendet wird run Der Exchange Log Name l uft gerade U5461 J Z135 6 59 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 atot absy stot sbsy wai Der Exchange Log Name steht noch aus Folgende Ursachen sind m glich Es besteht keine Verbindung zur LU6 2 Anwendung Der vorangegangene Exchange Log Name wurde mit einem Kommunikationsfehler abgebrochen Die Konfigurierungen von openUTM LU62 und der LU6 2 Ba
344. r aktuellen Konfiguration konsistent Kaltstart empfohlen W hrend des Warmstarts wird erkannt dass bestimmte Eintr ge der Synclog Datei nicht mit der aktuellen Konfiguration bereinstimmen genauer handelt es sich dabei um APT und AEQ der lokalen und der fernen OSI TP Anwendung Ein erfolgreicher Start von openUTM LU62 ist dann nur mehr mit dem Schalter c m glich Fehler beim Anlegen eines Shared Memory der Laenge amp LEN errno amp ERRNO amp ERRTEXT L sst der Application Context Transaktionssicherung zu so besorgt sich das Pro gramm u62_tp w hrend der Initialisierungsphase mit der Systemfunktion shmget einen Shared Memory Bereich der ein Abbild der Synclog Datei darstellt und auf den der Damon Prozess u62_w1 og lesend zugreift bevor er die Information auf Plat te schreibt Ein Fehler beim Anlegen dieses Shared Memory f hrt zum Abbruch von openUTM LU62 Die Systemvariable errno gibt Auskunft ber die genaue Ursache U5461 J Z135 6 275 Meldungen des Programms u62_tp Meldungen von openUTM LU62 037 040 041 042 Fehler beim Attach an das Shared Memory mit der Id amp ID errno amp ERRNO amp ERRTEXT Nach dem Anlegen eines Shared Memory wird diesem mit der Systemfunktion shmat eine Adresse zugewiesen um Schreib und Lesezugriffe zu erm glichen Geht dies schief bricht openUTM LU62 die Initialisierung ab Fehler in der Konfiguration der lokalen LU amp LLUNAME oder der Partner LU amp RLU
345. r alle Aktivitaten gestartet Dieses Level ist zur Diagnose von Performance Problemen gedacht Wird trace_optionen weggelassen so werden die Optionen in xap ange nommen loc_lu_alias_name Wenn der Schalter I nicht angegeben ist wirkt das Kommando auf alle openUTM LU62 Instanzen Ist der Schalter I angegeben so wirkt das Kommando nur auf die zu dieser LU geh renden Instanz Beispiel Einschalten des ausf hrlichem Trace mit Zeitmessung auf UNIX Systemen opt 1ib utmlu62 u62_adm ton in 3 xap Wenn Sie den Trace von Anfang an laufen lassen wollen k nnen Sie dies durch Op tion t beim Kommando u62_start erreichen Die Traces werden in folgenden Dateien abgelegt Instanz Trace Datei opt 1ib utm1u62 PROT inlog loc_lu_alias suff XAP TP Trace Datei opt 1ib utm1u62 PROT xaplog loc_lu_alias suffl suff2 Auf Windows Systemen liegen die Dateien entsprechend unter Programme utm1u62 PROT U5461 J Z135 6 63 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 3 3 8 Das Suffix suff nimmt zu Beginn den Wert 0 an Bei Erreichen einer Dateigr e von etwa einem halben Megabyte oder bei Eingabe des oben beschriebenen Flush Kommandos wird die Trace Datei geschlossen und eine neue Trace Datei mit einem um 1 erh hten Suf fix angelegt Nach Schlie en der Datei mit suff 9 beginnt suff wieder bei 0 Beim XAP TP Trace wird suff nur durch Eingabe eines Flush Kommandos hochgez hlt suff2 bei Erreichen der max
346. rammieren 20 Einschrittvorgang ohne Transaktionssicherung gt INIT MGET Client APRO DM KCPI gt A KCOF B MPUT NE KCRN gt A PEND KP FMH5 Daten gt RECEIVE STATE CSEND SEND LAST WAIT RETURN lt Daten CEB INIT MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND FI lt 21 Verarbeitungsquittung ohne Transaktionssicherung gt INIT MGET Client APRO DM KCPI gt A KCOF H MPUT NE KCRN gt A MPUT HM KCRN gt A PEND KP FMH5 Daten gt RECEIVE STATE CONFSEND ISSUE CONFIRMATION SEND LAST WAIT RETURN lt Daten CEB INIT MGET NT KCRN gt A KCRMGT C MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND F U5461 J Z135 6 143 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 22 Negative Verarbeitungsquittung ohne Transaktionssicherung gt INIT MGET Client APRO DM KCPI gt A KCOF H MPUT NE KCRN gt A MPUT HM KCRN gt A PEND KP FMH5 Daten gt RECEIVE STATE CONFSEND ISSUE ERROR SEND LAST WAIT RETURN lt FMH7 INIT MGET NT KCRN gt A KCRMGT E MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND F Start eines CICS Asynchron Vorgangs aus einem UTM Anwendungsprogramm 23 Start eines CICS Asynchron Vorgangs aus einem UTM Anwendungsprogramm ohne Transaktionssicherung INIT APRO AM KCPI gt A KCOF B FP
347. ramms u62_tp 308 309 310 311 Conversation wird abgelehnt TP Name amp TPNAME LU6 2 Seite ist Auftraggeber Fehler beim Austausch der Log Namen zwischen der lokalen und der fernen LU Der LU6 2 Partner hat zu openUTM LU62 eine Conversation mit Sync Level 2 auf gebaut obwohl zu diesem Zeitpunkt die Log Namen zwischen den beiden LUs noch nicht ausgetauscht waren oder es beim letzten Austausch der Log Namen zu einem schwerwiegenden Fehler gekommen ist Dieser Protokoll Versto wird von openUTM LU62 mit dem sofortigen Abbau der Conversation geahndet RECEIVE_ALLOCATE wegen Konfigurationsfehler zurueckgewiesen Der lokale LU Alias Name amp LUNAME ist nicht konfiguriert Der RECEIVE_ALLOCATE Aufruf zum asynchronen Annehmen von ankommen den Conversations ist von der LU6 2 Basis Software z B von TRANSIT zur ck gewiesen worden weil der in diesem Aufruf enthaltene Alias Name der lokalen LU nicht in der LU6 2 Basis Software konfiguriert ist RECEIVE_ALLOCATE fehlgeschlagen LU6 2 Basis Software laeuft nicht Der RECEIVE_ALLOCATE Aufruf ist negativ beantwortet worden weil die LU6 2 Basis Software nicht l uft Im Falle von TRANSIT als LU6 2 Basis Software ist ent weder das TRANSIT Grundsystem oder der LU62Mgr nicht gestartet openUTM LU62 setzt nach einer gewissen Wartezeit erneut einen RECEIVE_ALLOCATE Aufruf ab gibt aber im Fehlerfall diese Meldung nicht wieder aus RECEIVE_ALLOCATE fehlgeschlagen Systemfehler
348. reffen Deshalb sind die obigen openUTM CICS Beispiele im folgenden nochmals mit CPI C mit CPI RR formuliert Vergleich mit KDCS Aufrufen Im folgenden soll versucht werden die CICS Kommandos in ihrer Semantik mit KDCS Auf rufen zu vergleichen Adressierung eines fernen Vorgangs mit Transaktionssicherung CMINIT APRO DM AM KCOF C CMSSL CM_SYNC_POINT CMALLC U5461 J Z135 6 151 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 Adressierung eines fernen Vorgangs ohne Transaktionssicherung INIT APRO DM KCOF H SSL CM_CONFIRM ALLC ZW INIT APRO DM AM KCOF B SSL CM_NONE MALLC MDEDIITT CEP Entgegennahme einer Nachricht beim Auftragnehmer CMACCP INIT oder INIT PU CMRCV MGET Nachrichtenaustausch ohne Sicherungspunkt CMSEND MPUT NE CMRCV PEND KP INIT MGET Senden einer Nachricht und Anforderung zum Transaktionsende CMSEND MPUT NE KCRN gt SRRCMIT CTRL PR KCRN gt PEND KP INIT MGET NT KCRN gt Senden einer Nachricht und Anforderung Transaktions und Vorgangsende CMSEND MPUT NE KCRN gt CMDEAL CTRL PE KCRN gt SRRCMIT PEND KP INIT MGET NT KCRN gt 152 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C Nachrichtenaustausch und Anforderung zum Transaktionsende CMSST CM_SEND_AND_PREP_TO_RECEIVE MPUT NE KCRN gt CMSEND PEND
349. rforderlich wenn mit paralle len Sessions gearbeitet werden soll TERMINAL SESSION n mit n gt 1 NAME Iterm COMPT 1 ernennen weitere Parameter Die Operanden haben folgende Bedeutung Iterm definiert einen 1 8 Zeichen langen logischen Terminalnamen COMPT 1 spezifiziert die Ausgabekomponenten f r dieses Terminal Der Wert 1 korrespon diert mit dem COMPTn Operanden des TERMINAL Makros U5461 J Z135 6 241 IMS Generierung f r openUTM IMS Sessions openUTM IMS Kopplung ber LU6 1 7 1 1 Beispiele zu Abh ngigkeiten bei der openUTM IMS Generierung F r die mit Pfeilen gekennzeichneten Parameter m ssen Vereinbarungen zwischen dem IMS und dem UTM Anwender getroffen werden Beispiel openUTM unter UNIX Systemen oder openUTM unter BS2000 OSD bei Verwendung von TRANSIT CLIENT IMS ist PLU openUTM ist SLU 2 Sessions IMS openUTM m MAX TRMSGLTH 1024 COMM APPLID IMS13B _ _ SESCHA IMSPLU RECANY 10 4096 PLU Y EDTNAME ISCEDT gt DPN ISCEDT LPAP RNETNAME IMS13B SESCHA IMSPLU LNETNAME UTMIS TYPE UNITYPE LUTYPE6 TERMINAL OUTBUF 1024 NAME UTMIS SESSTON 1 SUBPOOL NAME I1S1 gt LSES I1X1 RSES I1S1 NAME LI1S1 TERMINAL OUTBUF 1024 LPAR 284 NAME UTM2S gt LNETNAME UTM2S SESSTON 1 SUBPOOL NAME I1S2 gt LSES I1X2 RSES 11S2 NAME LI2S1 Sessionaufbau Der LSES Name z B 11X1 wird im IMS nur
350. riffe auf gesch tzte Ressourcen Auditing Request Unit RU Nettodatenteil eines SNA Protokollelements Siehe auch RU Size Request Size RU size Maximall nge einer Request Unit Diese L nge muss blicherweise auf beiden Systemen eingestellt werden Sie wird dann beim Sessionaufbau ausgehan delt Resync Resynchronisation In der LU6 1 bzw LU6 2 Protokolldefinition festgelegtes Verfahren das nach einem Verbindungsabbruch oder Rechnerabsturz offene verteilte Transak tionen zu konsistenten Zust nden f hrt Resync Service Transaction Program Resync TP Teil des LU6 2 Protokolls das im Falle von Conversations mit Sync Level 2 ben tigt wird Das LU6 2 Protokoll legt fest dass vor dem Aufbau einer Conversation mit Sync Level 2 die beiden Resync TPs der jeweiligen LUs ihre Log Namen austau schen m ssen Im Falle eines Verbindungsverlustes oder Systemabsturzes wird das Resync TP au erdem zum Resynchronsieren der abgebrochenen Transaktionen ben tigt Das Resync TP hat den durch LU6 2 festgelegten TP Namen X 06F2 Secondary Logical Unit SLU Siehe Primary Logical Unit Session Unter einer Session versteht man eine Kommunikationsbeziehung zwischen zwei LUs allgemeiner zwischen zwei adressierbaren SNA Instanzen Zwischen einer LU auf einem System mit PU Typ 2 und einer LU auf einem Hostsystem PU Typ 5 kann nur eine Session aufgebaut werden Man spricht hierbei auch von einer dependent Session da der Host der dominierende P
351. ript realisiert ist l sst die Performance zu w nschen brig Es ist also die Geduld der Aufrufers gefordert nicht die DEL Taste bet tigen Der aktuelle User ist nicht zur Administration von openUTM LU62 berechtigt Benutzer des UNIX Systems ungleich root die nicht in der Konfigurationsdatei u62_users aufgelistet sind d rfen mit Ausnahme einer Trace Auswertung keine Administrationskommandos ausf hren Instanz amp INST Fehler beim Verbindungsaufbau ueber Sockets errno amp ERRNO amp ERRTEXT u62_adm kann die Socketverbindung zur Instanz amp INST nicht aufbauen Der Fehler code ERRNO stammt von der Systemfunktion connect Instanz amp INST Fehler beim Absenden der Meldung zum Gateway errno amp ERRNO amp ERRTEXT Instanz amp INST Fehler beim Absenden der Meldung zum Gateway Anzahl geschriebener Bytes fehlerhaft Die Systemfunktion send zum Absenden des Requests an die Instanz hat nicht das erwartete Ergebnis n mlich die L nge der Nachricht in Byte geliefert Dieses Fehlverhalten f hrt jedoch nicht zum Abbruch des Administrationsprogramms Instanz amp INST Fehler beim Abholen der Quittung vom Gateway errno amp ERRNO amp ERRTEXT Instanz amp INST Fehler beim Abholen der Quittung vom Gateway Anzahl gelesener Bytes fehlerhaft Die Systemfunktion recv zum Abholen der Quittung von der Instanz amp INST hat nicht das erwartete Ergebnis gebracht was zum Abbruch des Programms f hrt Wird al
352. ription lu_name TO2CGEIA lu_session_limit 100 pu_name lt 0000000000000000 gt nau_address 0 default_pool NO syncpt_support YES lu_attributes NONE sscp_id 0 disable NO sys_name timeout 60 back_level NO define_mode ode_name MODDIS89 description ax_neg_sess_lim 100 plu_mode_session_limit 15 in_conwin_src 1 in_conloser_src 0 uto_act 0 receive_pacing_win 4 ax_receive_pacing_win 0 default_ru_size YES ax_ru_size_upp 4096 ax_ru_size_low 0 cos_name CONNECT o define_directory_entry resource_name DESNIO00 M88 resource_type ENCP_RESOURCE description Auto defined remote node lt 0000000000000000000000000000000000 gt parent_name parent_type ENCP_RESOURCE define_directory_entry resource_name DESNIO00 M88 resource_type LU_RESOURCE description Auto defined default LU parent_name DESNIO00 M88 parent_type ENCP_RESOURCE 19 4 6 5 6 7 10 43 10 43 10 43 U5461 J Z135 6 101 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 Ldefine_directory_entry resource_name DESNIO00 A9CICSTE 3 43 resource_type LU_RESOURCE description parent_name DESNIO00 M88 10 43 parent_type ENCP_RESOURCE Parameter die bereinstimmen m ssen Die wesentlichen Parameter in diesem Beispiel sind
353. rmation ber offene Transaktion TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Log Records RECORDS LU6 2 Resync Rolle ROLE Diese Meldung beschreibt die beim Start der openUTM LU62 Instanz in der Synclog Datei gefundenen Log Records amp TPNAME bezeichnet den Transaktionscode des Auftragnehmers der vom Auf traggeber aufgerufen wurde amp PARTNER kann den Wert LU6 2 oder OSI TP haben Bei LU6 2 wurde vom LU6 2 Partner z B von einem CICS Programm der UTM Transaktionscode amp TPNAME aufgerufen Bei OSI TP wurde von einem UTM Anwendungsprogramm der Trans aktionscode amp TPNAME beim LU6 2 Partner also z B der CICS Transaktionscode amp TPNAME aufgerufen Die Transaktion kann eindeutig durch ihre LUWID und ihre AAID identifziert wer den Der LU6 2 Partner kennt nur die LUWID der Transaktion sie wird im Fehlerfall z B im CICS Logfile ausgegeben Die UTM Anwendung kennt nur die AAID der Transaktion sie wird im Fehlerfall im SYSLOG von UTM ausgegeben amp RECORDS beschreibt die Zustandsinformation der Transaktion Die einzelnen Werte sind unten beschrieben amp ROLE beschreibt die Rolle der openUTM LU62 Instanz beim Transaktionswieder anlauf zum LU6 2 Partner Die einzelnen Werte sind unten beschrieben RECORDS Beschreibung agent committed Der LU6 2 Partner hat die
354. rrno amp ERRNO amp ERRTEXT Der Systemaufruf fork zum Starten des Write Log D mon in der Startphase oder nach dem von u62_tp festgestellten Verschwinden von u62_wl og ist schiefgegan gen Dies ist grunds tzlich auf einen Betriebsmittelmangel des Systems zur ckzu f hren Der Inhalt der Variablen errno amp ERRNO gibt genaueren Aufschluss ber die Ursache u62_tp unternimmt nach einer gewissen Wartezeit einen erneuten Startversuch 280 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp 068 069 070 071 072 073 074 075 Fehler beim Starten des Write Log Daemons mittels execv errno amp ERRNO amp ERRTEXT Diese Meldung hat die gleiche Bedeutung wie die Meldung 067 mit dem Unter schied dass nicht die Funktion fork sondern execv zum berlagern des Prozes ses mit dem Programm u62_w1og schiefgegangen ist Diese Fehlermeldung deutet entweder auf einen Betriebsmittelengpass auf dem System oder auf eine fehlerhaf te Umgebung hin u62_w1og nicht vorhanden oder nicht ablauff hig Meldung an den Write Log Daemon mit PID amp PID konnte nicht abgesetzt werden Beende und restarte den Daemon Beim Schreiben einer internen Nachricht in die Named Pipe zum Write Log D mon mit write ist ein Fehler aufgetreten der nicht zum Abbruch von u62_tp gef hrt hat Dieser Meldung geht immer eine der Meldungen 052 054 voraus u62_tp beendet daraufhin den Write Log D mon gibt alle z
355. rtprotokoll und unterst tzt den verbindungslosen Datenaus tausch zwischen Rechnern Das UDP wurde definiert um auch Anwendungsprozessen die direkte M glich keit zu geben Datagramme zu versenden und damit die Anforderungen trans aktionsorientierten Verkehrs zu erf llen UDP baut direkt auf dem darunter lie genden IP Protokoll auf UDP hat einen minimalen Protokollmechanismus und garantiert weder die Ablieferung eines Datagrammes beim Zielpartner noch sind Vorkehrungen gegen eine Duplizierung oder eine Reihenfolgevertauschung getroffen Variable length variable blocked VLVB Festlegung innerhalb des LU6 1 Protokolls wie die Benutzerdaten zu transferie ren sind VLVB legt fest dass Benutzerdaten in Bl cke zu maximal 32765 Byte aufzutrennen sind mit jeweils einem 2 Byte gro en L ngenfeld davor Alternativ k nnen die Benutzerdaten auch als chain of RUs transferiert werden Im UTM Anwendungsprogramm sind diese beiden Alternativen nicht sichtbar im CICS Anwendungsprogramm sind sie jedoch sichtbar Virtual Telecommunications Access Method VTAM Komponente in einem IBM Hostsystem die f r die Datenfernverarbeitung zust ndig ist Manchmal wird stattdessen auch ACF VTAM verwendet U5461 J Z135 6 371 372 U5461 J Z135 6 Abk rzungen AAID ACF ACSE AE AEQ APDU APPC APT ASCII BB BCAM CCR CD CEB CICS CMX CPI C CPI RR DPL DPN DRI DTP EB EBCDIC ECI EDI EIB Atomic Action Identifier Adva
356. rtsetzung lt FMH7 FMH7 Response gt RR_OK lt K034 gt INIT KCKNZVG R MGET Client MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP Prepare gt CMRCV gt CM_TAKE_COMMIT_ DEALLOCATE SRRCMIT lt RequestCommit INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI Committed gt lt Forget RR_OK PAR Es ist zu beachten dass das UTM Anwendungsprogramm in diesem Fall nach dem SRRBACK keine Statusnachricht vom Auftragnehmer erh lt openUTM stellt dem Anwen dungsprogramm nur dann eine Statusnachricht vom Autragnehmer zu wenn der Auftragnehmer durch das R cksetzen der Transaktion beendet wurde Neben der K034 Meldung wird die Nachricht an den Client vom letzten Sicherungspunkt nochmal an den Client gesendet hnlich wie in den Beispielen 12 und 13 k nnen einige UTM Aufrufe entfallen wenn man im Teilprogramm auf die Rollback Commit Information von CICS verzichtet Der 2 und 3 Programmabschnitt reduziert sich dann auf die Folge INIT MGET NT KCRN gt A VGST 0 TAST 0 CTRL PR KCRN gt A MPUT NE Client PEND KCOM RE U5461 J Z135 6 171 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 20 Einschrittvorgang ohne Transaktionssicherung gt INIT MGET Client APRO DM KCPI gt A KCOF B MPUT NE KCRN gt A PEND KP FMH5 Daten gt CMACCP CMRCV gt CM_SEND_RECEIVED CMSEND CMDEAL l
357. s Instanz ausgegeben so stehen noch mindestens zwei Quittungen von unterschiedlichen Instanzen aus 354 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen von u62_gen 10 3 4 Meldungen von u62_gen 03 04 05 06 07 08 09 10 20 21 22 23 24 25 26 27 28 29 30 Unbekannter Text in Zeile amp LINENO ab amp INVTXT ueberlesen Kein Komma am Anfang der Zeile erlaubt Fehler in Zeile amp LINENO Kein Komma am Ende einer Anweisung erlaubt Fehler in Zeile amp LINENO Komma erwartet in Zeile amp LINENO1 oder amp LINENO2 Komma an der falschen Stelle in Zeile amp LINENO Zahl erwartet Fehler in Zeile amp LINENO ab amp INVTXT Unzulaessiger Name Fehler in Zeile amp LINENO ab amp INVTXT INSTANCE muss allein in einer Zeile stehen Parameter mehrfach angegeben Fehler in Zeile amp LINENO Unzulaessige Anzahl von Elementen im OBJECT IDENTIFIER Fehler in Zeile amp LINENO Ein Object Identifier besteht aus mindestens 2 und h chstens 10 ganzen Zahlen Werden diese Grenzen nicht eingehalten gibt u62_gen diese Fehlermeldung aus Syntaxfehler in Zeile amp LINENO Rest bis Zeile amp LINENO ueberlesen Diese Meldung wird immer zusammen mit Meldung 22 ausgegeben und zeigt an in welcher Zeile sich der Parser nach einem Syntax Fehler in der Eingabedatei wieder aufsynchronisert hat und mit der Bearbeitung fortf hrt Name amp NAME zu lang Fehler in Zeile amp LINENO Wert amp VAL ausserhalb
358. s Netzwerk namens betroffen ist Der Netzname der lokalen LU amp ALIASNAME ist wieder richtiggestellt Diese Meldung hat die gleiche Bedeutung wie Nummer 044 mit der lokalen statt der fernen LU Aufbau neuer Conversations wieder moeglich Diese Meldung erscheint gemeinsam mit Meldung 043 und oder 045 und zeigt an dass nach einer Richtigstellung ge nderter Netzwerknamen wieder Conversations zum LU6 2 Partner aufgebaut werden k nnen Der Knoten ist aktiviert Conversationaufbau moeglich Der Knoten des IBM Communications Server ist erfolgreich gestartet worden Con versations zum LU6 2 Partner k nnen jetzt wieder aufgebaut werden Der Knoten ist deaktiviert Kein Conversationaufbau moeglich Der Knoten des IBM Communications Server ist vermutlich durch Eingriff des Ad ministrators gestoppt worden Conversations zum LU6 2 Partner k nnen jetzt nicht mehr aufgebaut werden Der Attach Manager laeuft bereits Keine Zustellung ankommender Conversations F r die lokale LU der Instanz von openUTM LU62 ist bereits ein Attach Manager gestartet eventuell eine open UTM LU62 Instanz in einer weiteren Umgebung Va riable U62_DIR In diesem Fall werden alle vom LU6 2 Partner beim IBM Commu nications Server ankommenden Anforderungen zum Conversationaufbau nicht an die openUTM LU62 Instanz weitergegeben sondern an eine andere Anwendung D h es ist nur noch ein aktiver Verbindungsaufbau zum LU6 2 Partner m glich U5461 J Z135
359. s aufge baut sein 2 Sessions werden immer zur internen Verwaltung ben tigt Sessions busy Anzahl der belegten Sessions Eine Session ist belegt wenn gerade eine Conversation eine Programm Programm Kommunikati on ber diese Session l uft 60 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren 3 3 5 3 3 6 Weitere Zustandsinformationen insbesondere in Fehlerf llen befinden sich in der Datei opt 1ib utmlu62 PROT prot luname UNIX Systeme bzw Programme utml u62 PROT prot luname txt Windows Systeme Verbindungen aufbauen Mit dem Kommando u62_adm k nnen Sie auch Verbindungen zur UTM Anwendung oder zur LU6 2 Anwendung aufbauen Aufrufsyntax opt 1ib utml u62 u62_adm co cs C 1 loc_lu_alias_name Beschreibung CO Connect OSI TP Es wird eine parallele Verbindung ber OSI TP zur UTM Anwendung aufgebaut CS Connect SNA Es wird eine SNA LU6 2 Session zur LU6 2 Anwendung aufgebaut loc_lu_alias_name Wenn der Schalter I nicht angegeben ist wird von jeder openUTM LU62 Instanz eine Verbindung aufgebaut Ist der Schalter I angegeben so wird nur von der zu dieser LU geh renden Instanz eine Verbindung aufgebaut Ob der Verbindungsaufbau erfolgreich war m ssen Sie mit einem nachfolgenden u62_sta berpr fen Verbindungen abbauen Mit dem Kommando u62_adm k nnen Sie auch Verbindungen zur UTM Anwendung oder zur LU6 2 Anwendung abbauen Syntax op
360. s hierf r die Komponente APPC IMS verwendet werden APPC IMS ist Teil von IMS TM Es benutzt 2 Komponenten des Be triebssystems z OS APPC MVS und RRS MVS Soll eine IMS Anwendung LU6 2 Proto kolle nutzen so muss bei den IMS Startup Parametern oder im Member DFSPBxxx von IMS PROCLIB der Wert APPC Y angegeben werden Bei transaktionsgesicherter Kom munikation muss zus tzlich RRS Y angegeben werden Beispiel f r IMS Startup Parameter in der sogenannten DCC Prozedur PROC RGN 2000K SOUT A DPTY 14 15 SYS SYS1 SYS2 RGSUF IV1 PARMI APPC Y PARM2 RRS Y APPLIDI IMS81CR1 AOIS R TEFPROC EXEC PGM DFSMVRCO DPRTY amp DPTY REGION amp RGN PARM CTL amp RGSUF amp PARM1 amp PARM2 amp APPLID1 amp AOIS APPC MVS ist ein Subsystem im Betriebssystem z OS das das LU6 2 Protokoll realisiert RRS MVS Resource Recovery Services ist eine Komponente im Betriebssystem die als Sync Point Manager das 2 Phase Commit zwischen Datenbanken und LU6 2 Partnern ko ordiniert U5461 J Z135 6 177 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 5 1 2 Definition des LU Namens von IMS F r die LU6 2 Kommunikation ben tigt IMS eine APPLID die nicht mit der APPLID f r sonstige SNA Kommunikation identisch sein darf Die APPLID fungiert als LU Name Sie muss in VTAM definiert sein Beispiel f r eine derartige VTAM Definition IMS VBUILD TYPE APPL APPLICATION MAJOR NODE IMSAPPL1 APPL ACBNAME IMSAPPL
361. saction 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 0199 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 1306 XML Spezifikation des W3C www Konsortium Web page http www w3 org XML 394 U5461 J Z135 6 Stichw rter A ACCESS POINT Anweisung 49 Administration von openUTM LU62 unter Windows Systemen 54 Agent 359 AIX Systeme IBM CS Gateway f r LU6 2 Kopplung 31 LU6 2 Kopplung ber IBM CS 27 Alias Name 47 50 55 ALLOC TIME 45 ALLOCATE IMS Kommando 208 ALREADY_VERIFIED 183 Alternate Facility 359 Anynet 28 359 APPC 37 359 APPL CONTEXT 45 APPL Definition IMS Beispiel f r LU6 2 186 Application Context 45 Application Entity 36 49 Application Entity Qualifier 46 49 Application Process Title 47 50 APPLID IMS 178 APRO siehe KDCS Aufruf ASCII 48 49 234 ASSOCIATIONS 45 Assoziation 359 Asynchron Auftrag bei CICS mit LU6 1 232 bei CICS mit LU6 2 131 144 bei CPI C 160 175 bei IMS 244 mit und ohne Transaktionssicherung 132 145 176 Pseudo Dialog 249 Asynchronous Processing 108 218 232 Attach Header 221 228 360 B Back end Transaction 360 Backout 360 Basic Conversation 120 360 BCAM Generierung 92 B
362. saction Server IMS ab Version 6 TXSeries auf System p5 fr her RS 6000 CPI C Anwendungsprogramme auf IBM System i5 fr her AS 400 ltere IBM Transaktionsmonitore wie z B IMS bis zur Version 5 k nnen nur mittels LU6 1 transaktionsgesichert erreicht werden openUTM kann f r die verteilte Transaktionsverarbeitung die Protokolle LU6 1 OSI TP und LU6 2 verwenden Bei neu einzurichtenden Kopplungen in die IBM Welt sollte nur noch LU6 2 verwendet wer den sofern es die Partner Anwendung unterst tzt F r eine Kopplung zwischen openUTM und einem LU6 2 Partner wird das Produkt openUTM LU62 und eine zum Betriebssystem passende SNA Basis Software ben tigt openUTM LU62 ist auf den Betriebssystemen Solaris Windows Linux und AIX verf gbar Folgende Software Konfigurationen stehen zur Verf gung openUTM LU62 auf Solaris mit den Produkten TRANSIT SERVER und TRANSIT CPIC openUTM LU62 auf Solaris mit SNAP IX openUTM LU62 auf Windows mit IBM Communications Server for Windows openUTM LU62 auf Linux mit IBM Communications Server for Linux openUTM LU62 auf AIX mit IBM Communications Server for AIX Im vorliegenden Handbuch werden Namen der IBM Produkte wie z B IBM Communicati ons Server for Linux abgek rzt mit IBM Communications Server U5461 J Z135 6 23 Kopplung mit IBM Systemen Im Folgenden werden die typischen Konfigurationen bei einer Kopplung zwischen openUTM und einem IBM Produkt aufgelistet
363. schen KCSECTYP S und KCSECTYP P U5461 J Z135 6 77 openUTM CICS Kopplung generieren openUTM CICS Kopplung ber LU6 2 DEFINE SESSIONS Mit dieser Definition werden die Eigenschaften der Verbindung zur Stellvertreter LU in openUTM LU62 beschrieben DEFINE SESSIONS session_name GROUP group_name CONNECTION connection_name MODENAME modename PROTOCOL APPC MAX IMUM maxl max2 SENDSITZE ru_size RECEIVESIZE ru_size AUTOCONNECT NO YES ALL INSERVICE YES BUILDCHAIN YES IOAREALEN data_length Die Operanden haben folgende Bedeutung SESSIONS session_name Name der Sessions Definition Dieser Name kommt nur in den CICS Definitionen vor GROUP group_name 1 8 Zeichen langer Name Der CICS Systemverwalter muss diesen Namen verge ben Der Name kommt nur in den CICS Definitionen vor Es sollte derselbe Name wie in der zugeh rigen Connection Definition gew hlt werden CONNECTION connection_name Name der zugeh rigen Connection Definition MODENAME modename 1 8 Zeichen langer Modename f r die Verbindung zwischen CICS und openUTM LU62 Der Name muss auch in VTAM und der LU6 2 Basis Software TRANSIT SERVER SNAP IX bzw IBM Communications Server und openUTM LU62 als Modename definiert sein PROTOCOL APPC Es wird eine LU6 2 Verbindung definiert MAXIMUM max1 max2 Mit max1 wird die Maximalzahl von Sessions zwischen den beiden LUs festgelegt Der Wert muss zwischen 1 und 254 liegen Bei Verwendung von TRANS
364. siert sind m ssen in der IMS Systemdefinition ber ein TRANSACT Makro definiert werden Zus tz lich muss das zugeh rige Anwendungsprogramm mit einem APPLCTN Makro definiert werden IMS Transaktionscodes die mit CPI C realisiert sind m ssen dagegen im TP_Profile von APPC MVS definiert werden Beispiel f r APPLCTN und TRANSACT Makro APPLCTN GPSB IMS1PG1 PGMTYPE TP TRANSACT CODE IMS1TR1 MSGTYPE RESPONSE INQUIRY NO MODE SNGL Dabei bezeichnet IMS1PG1 den Namen des Programms und IMS1TR1 den Namen des Transaktionscodes Bei Mehrschritt Transaktionen muss im TRANSACT Makro der Parameter SPA angege ben werden Der Wert dieses Parameters beschreibt die Gr e einer sogenannten Scratchpad Area Sie dient dazu Daten ber mehrere Dialogschritte hinweg verf gbar zu halten Beispiel f r eine TP_Profile Definition TPADD TPSCHED_EXIT DFSTPPEO TPNAMECIMSITPN SYSTEM ACTIVECYES TPSCHED_DELIMITER TRANCODE IMS1SRVR CLASS 15 MAXRGN 20 RAC F NONE CPUTIME 100 Ht Dabei bezeichnet IMS1TPN den LU6 2 TP Namen also den Namen der von openUTM aus angesprochen werden muss Der beim Parameter TRANCODE verwendete Name IMS1SVR kann unterschiedlich von diesem Namen gew hlt werden und wird dann in IMS als Transaktionscode verwendet U5461 J Z135 6 179 openUTM IMS Kopplung generieren openUTM IMS Kopplung ber LU6 2 5 1 4 Definition von Partner LU und openUTM Transaktionen Agiert IMS nur als Auftragnehmer so
365. sind keine weiteren Definitionen in IMS erforderlich Agiert IMS auch als Auftraggeber so muss die Adressinformation f r das Partner Pro gramm generiert werden IBM empfiehlt Partner Transaktionen als Side Information in APPC MVS zu definieren Der Begriff Side Information kommt aus dem Umfeld von CPI C In der Side Information werden einem symbolischen Namen symbolic destination name Partner LU Name Part ner TP Name und MODE Name zugeordnet Der symbolische Name wird dann in den An wendungsprogrammen zur Adressierung der Partner Transaktion verwendet Eine Side In formation in APPC MVS sieht z B wie folgt aus SIADD DESTNAME DESTUTM1 TPNAME UTMTACO1 MODENAME APPCMODE PARTNER_LU APPCLUX Der Name der Side Information Datei muss IMS bekannt gegeben werden Dies geschieht mit einer SIDEINFO Anweisung in der SYS1 PARMLIB APPCPMxx SIDEINFO DATASET SYS1 APPCST Wird die Standard DL I Programmschnittstelle verwendet ohne die LU6 2 Erweiterungen des CHNG Aufrufs so kann die openUTM Transaktion nicht Uber Side Information adres siert werden Stattdessen muss ein LTERM Name verwendet werden Ein LTERM in IMS ist hnlich wie bei openUTM ein symbolischer Name f r einen Kommunikationspartner der an der DL I Programmschnittstelle verwendet wird LTERM Namen m ssen mittels IMS Generierungsparameter einem realen Kommunikationspartner zugeordnet werden Bei dieser Art von Adressierung muss zun chst ein Alternate PCB definiert
366. sis Software TRANSIT SERVER SNAP IX bzw IBM Commu nications Server sind inkompatibel d h bei laufendem openUTM LU62 wurde die Konfigurierung der LU6 2 Basis Software ge ndert ok Der Exchange Log Name wurde erfolgreich durchgef hrt err Schwerwiegender Fehler beim Exchange Log Name rst Restart Wird als XLN Status angezeigt solange das Recovery zur UTM Anwendung noch nicht abgeschlossen ist Der Austausch der Log Namen mit dem LU6 2 Partner konnte erfolgreich durchgef hrt werden Dieser Zustand h lt nach dem Start der Instanz nur kurze Zeit an kann allerdings auch l ngere Zeit bestehen bleiben wenn der LU6 2 Partner f r das Recovery der Transaktion verantwortlich ist Wenn err oder rst angezeigt wird oder wai trotz bestehender Verbindung so stehen weitere Informationen in der Datei opt 1ib utm1u62 PROT prot luname UNIX Systeme bzw Programme utml u62 PROT prot luname txt Windows Systeme Associations total Anzahl der aufgebauten parallelen Verbindungen zwi schen der openUTM LU62 Instanz und der UTM Anwendung Associations busy Anzahl der belegten parallelen Verbindungen zur UTM Anwendung Eine parallele Verbindung ist belegt wenn gerade eine Pro gramm Programm Kommunikation ber diese Verbindung l uft Sessions total Anzahl der aufgebauten LU6 2 Sessions zwischen der openUTM LU62 Instanz und dem LU6 2 Partner Soll eine Kommunikation zum LU6 2 Partner m glich sein so m ssen mindestens 3 Session
367. st Auftraggeber Restart der Kontrollinstanz ist noch nicht abgeschlossen Der OSI TP Partner d h die UTM Anwendung hat zu openUTM LU62 einen OSI TP Dialog mit Functional Unit Commit aufgebaut zu einem Zeitpunkt als nach dem Start von openUTM LU62 der Wiederanlauf der noch bestehenden Transak tionen noch nicht abgeschlossen war In dieser Situation ist die XAP TP Kontroll instanz noch nicht in der Lage die Transaktionssicherung auf neuen OSI TP Dialo gen mit Functional Unit Commit zu unterst tzen openUTM LU62 weist deshalb den OSI TP Dialogwunsch ab amp TPNAME bezeichnet den TP Namen auf LU6 2 Seite also z B den CICS Transaktionscode Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Der ferne Application Process Title stimmt nicht mit der Konfigurierung ueberein U5461 J Z135 6 297 Meldungen des Programms u62_tp Meldungen von openUTM LU62 375 376 377 378 Ankommender Dialogwunsch abgelehnt TP Name amp TPNAME OSI TP Seite ist Auftraggeber Der ferne Application Entity Qualifier stimmt nicht mit der Konfigurierung ueberein openUTM LU62 hat vom OSI TP Partner d h von der UTM Anwendung eine TP_BEGIN_DIALOGUE indication mit einem APT application Process Title bzw AEQ Application Entity Qualifier empfangen der nicht mit der Generierung von openUTM LU62 bereinstimmt Die entsprechenden Parameter in der openUTM LU62 Generierung die gegebenenfalls zu modifiziere
368. stener Sockets der Instanz beinhalten soll ist ein Fehler aufgetreten in der Systemfunktion open oder write Die Instanz beendet sich daraufhin Fehler beim Annehmen einer ankommenden TCP IP Verbindung errno amp ERRNO amp ERRTEXT Die Systemfunktion accept zum Annehmen einer ankommenden Verbindungsan forderung von einem Administrationsprogramm ist mit dem Fehlercode ERRNO schiefgegangen Dies f hrt jedoch nicht zum Abbruch sondern ist nur als Hinweis zu verstehen U5461 J Z135 6 315 Meldungen des XAP TP Providers Meldungen von openUTM LU62 10 2 Meldungen des XAP TP Providers Die Meldungen des XAP TP Providers werden in die gleiche Datei wie die Meldungen des Programms u62_tp ausgegeben Sie beginnen mit dem Buchstaben P Die Werte der In serts sind entweder im Anschluss an die Meldung erl utert oder f r mehrfach vorkommen de Inserts in Abschnitt Allgemeine Inserts der XAP TP Meldungen auf Seite 334 aufge f hrt Ohne Verwendung von TNSX werden in den folgenden Meldungen die lokalen Access Points und Partner Adressen wie folgt dargestellt T LOCTSEL 26544 T REMTSEL host 5632 Die entsprechenden Inserts sind im Folgenden mit markiert P001 Fehler beim OSS Aufruf XPFUNC amp XPRET amp XPERR amp XP1INFO amp XP2INFO Diese Meldung wird ausgegeben wenn der Aufruf einer OSS Funktion amp XPFUNC einen Fehler liefert Handelt es sich um einen vom Transportsystem gemeldeten Fehler
369. t Daten CEB INIT MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND FI 172 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C 21 Verarbeitungsquittung ohne Transaktionssicherung gt INIT MGET Client MPUT NE KCRN gt A MPUT HM KCRN gt A PEND KP INIT MGET NT KCRN gt A KCRMGT C MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND F oe APRO DM KCPI gt A KCOF H FMH5 Daten lt Daten CEB C OOQ ACCP CMRCV gt CM_CONFIRM_SEND_ RECEIVED CFMD SEND SDT CM_DEALLOCATE_FLUSH DEAL U5461 J Z135 6 173 Verwendung der Programmschnittstelle CPI C openUTM CICS Kopplung ber LU6 2 22 Negative Verarbeitungsquittung ohne Transaktionssicherung gt INIT MGET Client APRO DM KCPI gt A KCOF H MPUT NE KCRN gt A MPUT HM KCRN gt A PEND KP FMH5 Daten gt CMACCP CMRCV gt CM_CONFIRM_SEND_ RECEIVED SERR SEND SDT CM_DEALLOCATE_FLUSH DEAL aaoo lt FMH7 INIT MGET NT KCRN gt A KCRMGT E MGET NT KCRN gt A VGST C TAST U MPUT NE Client PEND F lt 174 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 Verwendung der Programmschnittstelle CPI C Start eines CPIC Asynchron Vorgangs aus einem UTM Anwendungsprogramm 23 Start eines CPI C Asynchron Vorgangs aus einem UT
370. t 1ib utml u62 u62_adm ao as do ds C 1 loc_lu_alias_name U5461 J Z135 6 61 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 3 3 7 Beschreibung a0 Abort OSI TP Es werden alle bestehenden parallelen Verbindungen zur UTM Anwendung abgebaut unabh ngig davon ob sie belegt sind oder nicht Abort SNA Es werden alle bestehenden SNA Sessions zur LU6 2 Anwen dung abgebaut unabh ngig davon ob sie durch eine Conversation Pro gramm Programm Kommunikation belegt sind oder nicht Disconnect OSI TP Es werden alle bestehenden parallelen Verbindungen zur UTM Anwendung abgebaut die nicht belegt sind Disconnect SNA Es werden alle bestehenden SNA Sessions zur LU6 2 Anwendung abgebaut Bei durch Conversations belegten Sessions wird der Abbau bis zum Conversation Ende verz gert Freie Sessions werden sofort abgebaut loc_lu_alias_name Wenn der Schalter I nicht angegeben ist werden von jeder openUTM LU62 Instanz die Verbindungen abgebaut Ist der Schalter I angegeben so werden nur von der zu dieser LU geh renden Instanz die Verbindungen abgebaut Ob der Verbindungsabbau erfolgreich war m ssen Sie mit einem nachfolgenden u62_sta berpr fen Trace ein und ausschalten Traceinformationen sind ein Hilfsmittel f r die Fehlerdiagnose in openUTM LU62 Bei ein geschaltetem Trace schreibt das Programm u62_tp laufend interne Informationen in spezi elle Trace Dateien
371. t einen heuristischen Mix gemeldet d h die betei ligten Datenbanken sind nicht konsistent Dies muss dem OSI TP Part ner d h der UTM Anwendung noch mitgeteilt werden log damage haz Der LU6 2 Partner hat Resync in progress gemeldet d h es ist nicht sicher ob die beteiligten Datenbanken konsistent sind Dies muss dem OSI TP Partner d h der UTM Anwendung noch mitgeteilt werden ROLE Beschreibung ACTIVE openUTM LU62 ist verantwortlich f r den Transaktionswiederanlauf zum LU6 2 Partner PASSIVE Der LU6 2 Partner ist verantwortlich f r den Transaktionswiederanlauf d h er muss ein Compare States senden NONE Aus Sicht von openUTM LU62 ist kein Transaktionswiederanlauf zum LU6 2 Partner erforderlich Verlust der Verbindung zum LU6 2 Partner Transaktion muss resynchronisiert werden TP Name amp TPNAME amp PARTNER Seite ist Auftraggeber LUWID LU6 2 LU name amp LUNAME instance amp INSTANCE sequence amp SEQUENCE AAID OSI TP size amp SIZE aaid amp AAID Wahrend der Commit Phase einer Transaktion ging die Verbindung zum LU6 2 Partner verloren Nach Wiederherstellung der Verbindung muss die Transaktion re synchronisiert werden Zur Bedeutung von amp TPNAME amp PARTNER LUWID und AAID siehe Meldung 402 U5461 J Z135 6 303 Meldungen des Programms u62_tp Meldungen von openUTM LU62 404 405 406 Naechster Wiederanlaufversuch in amp Z
372. t eines CICS Asynchron Auftrags aus einem UTM Anwendungsprogramm INIT APRO AM KCPI gt A FPUT NE KCRN gt A PEND FI FMH6 Daten SRQ gt lt Daten SRQ RETRIEVE RETURN SRQ Syncpoint Request SRSP Syncpoint Response U5461 J Z135 6 233 Hinweise zur openUTM CICS Programmierung openUTM CICS Kopplung ber LU6 1 6 10 Hinweise zur openUTM CICS Programmierung F r UTM Vorg nge die mit CICS Vorg ngen kommunizieren wollen sind bez glich der Programmierung folgende Hinweise zu beachten 1 Angabe von KCMF Formatname und KCDF Device Features Werden in UTM Anwendungsprogrammen Formatname und oder KCDF angegeben so werden diese per FMH4 bertragen Die FMH4 Behandlung muss im CICS Anwen derprogramm vorgesehen werden Nachrichtenteile MPUT NT FPUT NT Nachrichtenteile werden von openUTM normalerweise in VLVB Records bertragen Dabei werden alle Teile mit zugeh rigem L ngenfeld in einer oder mehreren RUs gesendet je nach NB Gr e CICS Anwendungsprogramme m ssen selbst f r die Entblockung sorgen Wenn im UTM Anwendungsprogramm jedoch Formatname und oder KCDF angege ben wird so sendet openUTM die Nachrichtenteile im Format Chain of RUs Vorgangswiederanlauf openUTM geht davon aus dass nach St rung der Kommunikation z B Verbindungs verlust die Verarbeitung am letzten Sicherungspunkt fortgesetzt wird CICS kann diese Funktion nicht erbringen Dies
373. tation Services Transaction Processing Exchange Log Name U5461 J Z135 6 375 376 U5461 J Z135 6 Literatur il Zu openUTM gibt es auch eine CD ROM Diese enth lt PDF Dateien von allen openUTM Handb chern Die Handb cher sind online unter http manuals ts fujitsu com zu finden oder in gedruckter Form gegen gesondertes Entgelt unter http manualshop ts fujitsu com zu bestellen Dokumentation zu openUTM openUTM Konzepte und Funktionen Benutzerhandbuch Zielgruppe Alle die sich einen berblick ber die Funktionsbreite und Leistungsfahigkeit von openUTM verschaffen wollen openUTM Anwendungen programmieren mit KDCS f r COBOL C und C Basishandbuch Zielgruppe Programmierer die f r die Programmierung von UTM Anwendungen die Programmschnitt stelle KDCS nutzen wollen openUTM Anwendungen generieren Benutzerhandbuch Zielgruppe Anwendungsplaner Anwendungsentwickler und Betreuer von UTM Anwendungen U5461 J Z135 6 377 Literatur openUTM Einsatz von openUTM Anwendungen unter BS2000 OSD Benutzerhandbuch Zielgruppe Anwendungsplaner Anwendungsentwickler Anwender und Betreuer von UTM Anwendun gen openUTM Einsatz von openUTM Anwendungen unter UNIX und Windows Systemen Benutzerhandbuch Zielgruppe Anwendungsplaner Anwendungsentwickler Anwender und Betreuer von UTM Anwendun gen openUTM Anwendungen administrieren Benutzerhandbuch Zielgruppe Administratoren und Programmierer von
374. te 217 In diesem Fall wird die Option SYSID nicht verwendet da die Partner Anwendung durch die Generierung bereits festgelegt wurde NOCHECK Es wird keine Antwort erwartet Wenn keine Session verf gbar ist wird die Nach richt bei CICS in eine Warteschlange eingeh ngt Falls wieder eine Session frei ist wird die Nachricht gesendet PROTECT Der ferne Asynchron Vorgang soll nicht gestartet werden bevor der CICS Vorgang einen SYNCPOINT oder ein RETURN Kommando abgesetzt hat Die Unterst tzung von RTRANSID und RTERMID ist ab Seite 249 beschrieben Weitere Optionen wie TERMID und FMH siehe CICS for MVS ESA Application Programming Reference werden von openUTM nicht unterst tzt Innerhalb einer CICS Transaktion LUW logical unit of work darf nur ein Start Kommando f r eine UTM Anwendung vorkommen 232 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 1 CICS Kommandos f r Asynchron Auftr ge RETRIEVE Mit dem RETRIEVE Kommando wird eine Asynchron Nachricht gelesen Das Kommando hat folgende Syntax EXEC CICS RETRIEVE INTO bereich SET pntr Die Unterst tzung von RTRANSID und RTERMID siehe CICS for MVS ESA Application Programming Reference ist ab Seite 249 beschrieben Beispiele f r den Austausch von Asynchron Auftr gen 1 Start eines UTM Asynchron Auftrags aus einem CICS Anwendungsprogramm START SYNCPOINT FMH6 Daten SRQ gt lt SRSP INIT FGET PEND FI 2 Star
375. te Log D mon u62_w1og wird von u62_tp w hrend der Initialisierung gestar tet wenn UDTCCR oder UDTSEC als Application Context konfiguriert ist also Wie deranlauf Information auf die Platte geschrieben werden muss Sobald u62_wlog seine Ready Nachricht an u62_tp gesendet hat ffnet u62_tp seine Output Pipe zu diesem D mon f r sp tere Auftr ge Geht der Systemaufruf open schief so wird diese Meldung ausgegeben mit dem Grund des Fehlers in der Variablen errno Abbruch des Write Log Daemon mit PID amp PID in der Startphase Der von u62_tp gestartete Write Log D mon u62_wlog konnte seine Initialisierung nicht erfolgreich durchf hren In diesem Fall sendet er noch eine entsprechende in terne Nachricht an u62_tp die zur Ausgabe der Meldung 061 f hrt und beendet sich daraufhin u62_tp versucht dann nach einer gewissen Wartezeit den Start von u62_wlog erneut U5461 J Z135 6 279 Meldungen des Programms u62_tp Meldungen von openUTM LU62 062 063 064 065 066 067 Write Log Daemon mit PID amp PID meldet Fehler beim Schreiben in die Log Datei gt Abbruch Das ffnen oder das Beschreiben der Synclog Datei durch den Write Log D mon ist misslungen Dieser Fehler f hrt sofort zum Abbruch von u62_tp Er sollte nur dann auftreten wenn aufgrund eines vollen Dateisystems nicht mehr gen gend Platz f r die Synclog Datei auf der Platte vorhanden ist Da sich die Gr e der Synclog Datei w hrend der Laufz
376. tei opt 1ib utmlu62 conffile gelesen u62_gen gibt die Daten nach stdout aus Fur Windows Systeme gelten dieselben Anmerkungen wie im Abschnitt Generierungspro gramm starten auf Seite 52 Namen der verwendeten Generierungsdatei anzeigen Haben Sie den Namen der verwendeten Generierungsdatei vergessen so k nnen Sie sich mit dem folgenden Kommando den Dateinamen anzeigen Das Kommando zeigt zus tzlich die internen Versionsnummern der Programme von openUTM LU62 an Aufrufsyntax opt lib utmlu62 u62_adm v F r Windows Systeme gelten dieselben Anmerkungen wie im Abschnitt Generierungspro gramm starten auf Seite 52 U5461 J Z135 6 53 openUTM LU62 administrieren LU6 2 Kopplungen mit openUTM LU62 3 3 openUTM LU62 administrieren 3 3 1 Administration unter UNIX und Windows Systemen Administration unter UNIX Systemen Unter UNIX Systemen k nnen Sie alle Administrationskommandos wie unten angegeben direkt aus der Shell aufrufen openUTM LU62 ist nach der Installation durch alle Benutzer administrierbar Soll der Kreis der Administratoren von openUTM LU62 eingeschr nkt werden so kann man in der Datei opt 1ib utmlu62 u62_users eine Liste mit allen zugelassenen Benutzerkennungen er stellen Diese Liste hat folgende Syntax Benutzerkennungen sind durch Komma Leerzeichen Tabulator oder Zeilenende Newline voneinander getrennt Der Benutzer root hat immer Administrationsberechti gung und braucht nicht ei
377. tem BS2000 OSD oder Windows System IBM Rechner CICS oder IMS openUTM oder TXSeries CMX PCMX bzw BCAM SNA Basis Software z B VTAM Linux bzw AIX Rechner PCMX openUTM LU62 IBM Communications Server Enterprise Extender SNA ber IP LU6 2 Kopplung ber Gateway Rechner mit IBM Communications Server auf Linux bzw AlX Systemen Im Falle von openUTM unter BS2000 OSD ist zus tzlich das Produkt OSS BS2000 OSD erforderlich Die Verbindung zwischen den beiden linken Rechnern erfolgt ber TCP IP mit RFC1006 Im Bild ist eine SNA Kopplung ber Enterprise Extender SNA ber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu IBM Communcations Server U5461 J Z135 6 31 LU6 2 Kopplung ber Gateway mit IBM Communications Server Kopplung mit IBM Systemen 2 8 LU6 2 Kopplung ber Gateway Rechner mit IBM Communications Server auf Windows Systemen Die folgende Kopplungsm glichkeit ber LU6 2 kann immer dann eingesetzt werden wenn der Rechner auf dem die UTM Anwendung l uft nicht direkt an das SNA Netz angebun den werden soll oder kann Das Betriebssystem dieses Rechners ist beliebig Es kann z B ein BS2000 OSD ein UNIX System oder ein WIndows System sein Als Gateway Rechner wird ein Windows System ben tigt UNIX System BS2000 OSD oder Windows System IBM Rechner CICS oder IMS openUTM oder TXSeries
378. tgegennehmen und an denselben Partner wieder eine Antwort zur cksenden k nnen oft ohne nderung auch mit LU6 2 Partnern kommunizieren Auch 2 Phase Commit Transaktionen k nnen auf diese Weise bearbeitet werden Zus tzlich ist es mit DL I m glich einem LU6 2 Partner eine asynchrone nicht transaktionsgesicherte Nachricht zu senden vergleichbar dem FPUT bei openUTM DL I bietet jedoch keine M glichkeit eine 2 Phase Commit Transaktion beim Partner aufzuru fen Auch das Setzen einer Userid beim Senden einer asynchronen Nachricht ist bei DL I nicht m glich In DL I stehen f r die Datenkommunikation folgende Aufrufe zur Verf gung Name Parameter Bedeutung Verwendung AUTH O PCB I O Area authorization Pr fen ob der angemeldete Benutzer be stimmte Funktionen aufrufen und Res sourcen nutzen darf CHNG _ Alt PCB dest name opt list change Adressieren eines Partners CMD O PCOB I O Area command Absetzen eines Administrations Kom mandos GCMD I O PCB I O Area get command Lesen der R ckmeldung zum Administra tions Kommando GU O POB I O Area get unique Lesen der ersten Nachricht GN O PCB I O Area get next Lesen einer Folgenachricht ISRT O PCB oder Alt PCB I O insert Senden einer Nachricht Area mod name 194 U5461 J Z135 6 openUTM IMS Kopplung ber LU6 2 openUTM IMS Kopplung programmieren PURG _ I O PCB oder Alt PCB purge Sofortiges
379. timer 30 mplicit_hpr_support NO mplicit_link_lvl_error NO mplicit_uplink_to_en NO effect_cap 3993600 connect_cost 0 byte_cost 0 security SEC_NONSECURE 16 13 13 98 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung generieren prop_delay PROP_DELAY_LAN user_def_parm_l 128 user_def_parm_2 128 user_def_parm_3 128 initially_active YES window_inc_threshold 1 test_timeout 10 test_timer_retry 5 xid_timer 10 xid_timer_retry 5 ack_timeout 5000 p_bit_timeout 5000 t2_timeout 100 rej_timeout 10 busy_state_timeout 30 idle_timeout 30 ax_retry 3 Ldefine_ethernet_ls Is_name M88 description IBM Host Muenchen port_name ETSAPO04 adj_cp_name DESNIO00 M88 adj_cp_type END_NODE ac_address lt 400037450001 gt Isap_address 0x04 auto_act_supp NO tg_number 0 limited_resource NO solicit_sscp_sessions NO pu_name lt 0000000000000000 gt disable_remote_act NO default_nn_server NO dspu_services NONE dspu_name lt 0000000000000000 gt 16 10 43 18 dlus_name lt 0000000000000000000000000000000000 gt bkup_dlus_name lt 0000000000000000000000000000000000 gt hpr_supported NO hpr_link_lvl_error NO link_deact_timer 30 use_default_tg_chars YES Is_attributes SNA local_node_id lt 00000000 gt cp_cp_sess_support NO effect_cap 3993600 connect_cost 0 byte_cost 0
380. ttmenge abbilden Details sind in den Abschnitten Hinweise zur openUTM Programmierung und Hinweise zur CICS Programmierung im folgenden Kapitel beschrieben U5461 J Z135 6 41 openUTM LU62 generieren LU6 2 Kopplungen mit openUTM LU62 3 2 3 2 1 openUTM LU62 generieren openUTM LU62 ben tigt zum Start bestimmte Konfigurierungsinformationen die der Sy stemverwalter in Form einer Konfigurationsdatei bereitstellen muss Das Erzeugen der Kon figurationsdatei erfolgt in 2 Schritten 1 Erstellen einer sogenannten Generierungsdatei mit einem Texteditor Der Aufbau der Generierungsdatei ist im nachfolgenden Abschnitt beschrieben 2 Erzeugen der bin ren Konfigurationsdatei aus der Generierungsdatei Hierzu muss das Programm u62_gen gestartet werden Genaueres siehe weiter unten Aufbau der Generierungsdatei In der Generierungsdatei m ssen alle Stellvertreter Anwendungen und deren Zuordnung zu den echten Partnern definiert werden Hierf r gibt es die INSTANCE Anweisung Pro openUTM LU62 Instanz ist eine INSTANCE Anweisung notwendig In einer Generierungs datei k nnen beliebig viele INSTANCE Anweisungen enthalten sein Format der INSTANCE Anweisung Das Wort INSTANCE muss allein in einer Zeile stehen Alle Parameter der INSTANCE Anweisung bestehen aus einem Schl sselwort dem Zei chen und einem Wert Parameter der INSTANCE Anweisung m ssen durch ein Komma getrennt werden wobei das Komma aber nie am Zeilenanfang
381. ttstellen 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 Wenn Sie Daten auf Basis von XML austauschen wollen ben tigen Sie das Dokument Data Marshalling mit XML f r openUTM Darin werden die C und COBOL Aufrufe beschrieben die zum Bearbeiten von XML Dokumenten ben tigt werden Diese Be schreibung ist nur als PDF Dokument erh ltlich online und auf CD F r BS2000 OSD gibt es Erg nzungsb nde f r die Programmiersprachen Assembler Fortran Pascal XT und PL 1 Diese sind nur als PDF Datei verf gbar online und auf der WinAdmin CD Konfigurieren Zur Definition von Konfigurationen steht Ihnen das Handbuch Anwendungen generieren zur Verf gung Darin ist beschrieben wie Sie f r eine UTM Anwendung mit Hilfe des UTM Tools KDCDEF die Konfiguration definieren und die KDCFILE 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 Version von openUTM oder nach nderungen in der Konfiguration U5461 J Z135 6 15 Wegweiser durch die Dokumentation zu openUTM Einleitung Binden Starten und Einsetzen Um UTM Anwendungen einsetzen zu k nnen ben tigen Si
382. uch nur online verf gbar Internet Zielgruppe Programmierer von UTM Assembler Anwendungen openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Fortran Erganzung zum Basishandbuch nur online verf gbar Internet Zielgruppe Programmierer von UTM Fortran Anwendungen U5461 J Z135 6 379 Literatur openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Pascal XT Erg nzung zum Basishandbuch nur online verf gbar Internet Zielgruppe Programmierer von UTM Pascal XT Anwendungen openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r PL I Erg nzung zum Basishandbuch nur online verf gbar Internet Zielgruppe Programmierer von UTM PL I Anwendungen WS4UTM UNIX und Windows Systeme Web Services f r openUTM nur online verf gbar Internet Zielgruppe Anwendungsplaner Anwendungsentwickler und Betreuer von UTM Anwendungen openUTM Masterindex nur online verf gbar Internet Zielgruppe Alle die mit der openUTM Dokumentation arbeiten m chten 380 U5461 J Z135 6 Literatur Dokumentation zum openSEAS Produktumfeld BeanConnect for openUTM Benutzerhandbuch Zielgruppe BeanConnect Entwickler und Administratoren Administratoren von Application Servern wie z B OracleAS OC4J Deployer EJB Entwickler und openUTM Administratoren BeanConnect for CICS Benutzerhandbuch Zielgruppe BeanConnect Entwickler und Administratoren Administratoren von Application Servern wie z B Oracl
383. uestCommit Committed gt Forget NORMAL Prepare gt RECEIVE STATE SYNCFREE SYNCPOINT ROLLBACK FMH7 FMH7 Response gt NORMAL Fortsetzung n chste Seite U5461 J Z135 6 141 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 Fortsetzung INIT KCKNZVG R MGET Client MPUT NE KCRN gt A CTRL PE KCRN gt A PEND KP Prepare gt RECEIVE STATE SYNCFREE SYNCPOINT lt RequestCommit INIT MGET NT KCRN gt A VGST C TAST P MPUT NE Client PEND FI Committed gt lt Forget gt NORMAL RETURN Es ist zu beachten dass das UTM Anwendungsprogramm in diesem Fallnach dem SYNCPOINT ROLLBACK keine Statusnachricht vom Auftragnehmer erh lt openUTM stellt dem Anwendungsprogramm nur dann eine Statusnachricht vom Autragnehmer zu wenn der Auftragnehmer durch das R cksetzen der Transaktion beendet wurde Neben der K034 Meldung wird die Nachricht an den Client vom letzten Sicherungspunkt nochmal an den Client gesendet hnlich wie in den Beispielen 12 und 13 k nnen einige UTM Aufrufe entfallen wenn man im Teilprogramm auf die Rollback Commit Information von CICS verzichtet Der 2 und 3 Programmabschnitt reduziert sich dann auf die Folge INIT MGET NT KCRN gt A VGST 0 TAST 0 CTRL PR KCRN gt A MPUT NE Client PEND KCOM RE 142 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung prog
384. ufbau ein Exchange Log Name Hierbei tau schen die beiden Partner ihre Log Namen aus Damit kann festgestellt werden ob seit dem letzten Verbindungsabbau einer der beiden Partner mit einem Kaltstart seine Log Records gel scht hat Hat ein Partner einen Kaltstart durchgef hrt der andere Partner aber nicht so entsteht ein Warm Cold Mismatch Dieser kann nur durch manuellen Eingriff aufgel st werden Bei openUTM LU62 wird ein Warm Cold Mismatch als XLN Zustand err ange zeigt Hat IMS einen Kaltstart durchgef hrt open UTM LU62 jedoch nicht so kann man dies durch Neustart der openUTM LU62 Instanz mit Kaltstartoption beheben Im umge kehrten Fall wenn also openUTM LU62 mit Kaltstart hochgefahren wurde IMS aber mit Warmstart ist ein Eingriff auf Seite von IMS notwendig 208 U5461 J Z135 6 6 openUTM CICS Kopplung ber LU6 1 In diesem Kapitel werden die Aspekte der openUTM CICS Kopplung ber LU6 1 sowie die zugeh rige Generierung und Programmierung behandelt Die Generierung und Programmierung f r eine openUTM CICS Kopplung ist f r den CICS Anwender weitgehend identisch mit einer IMS CICS Kopplung ber LU6 1 siehe CICS for MVS ESA Intercommunication Guide und CICS for MVS ESA Distributed Transaction Programming Guide 6 1 CICS Definitionen f r openUTM CICS Sessions In diesem Abschnitt soll das Generieren von Verbindungen zwischen CICS und openUTM dargestellt werden Generierungen f r CICS k nnen ber Ma
385. ugeh rigen Ressourcen frei und startet den Write Log D mon erneut ap_set_env fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Diese Meldung bedeutet einen internen Fehler bei der Verwendung der XAP TP Schnittstelle f r die Kommunikation ber OSI TP Dabei bedeuten amp INSTNO Nummer der XAP TP Instanz amp APERRNO XAP TP Fehlernummer amp ERRTXT XAP TP Fehlertext ap_get_env fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_free fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_bind fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_close fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_init_env fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 U5461 J Z135 6 281 Meldungen des Programms u62_tp Meldungen von openUTM LU62 076 077 078 079 080 081 082 083 090 ap_open fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_rcv fuer Instanz amp INSTNO fehlgeschlagen ap_errno amp APERRNO amp ERRTXT Siehe Kommentar zur Meldung 070 ap_snd fuer Instanz amp INSTNO fehlgeschlagen ap_errno
386. ugger Basishandbuch Benutzerhandbuch Zielgruppe Programmierer im BS2000 BCAM BS2000 OSD BCAM Band 1 2 Benutzerhandbuch Zielgruppe Netzplaner generierer und verwalter die in BS2000 Systemen BCAM betreiben BINDER BS2000 OSD Benutzerhandbuch Zielgruppe Software Entwickler BINDER BS2000 OSD Taschenbuch Zielgruppe Software Entwickler die im Umgang mit dem BINDER ge bt sind BS2000 OSD Makroaufrufe an den Ablaufteil Benutzerhandbuch Zielgruppe BS2000 OSD Assembler Programmierer BS2000 OSD BC BLSSERV Bindelader Starter Benutzerhandbuch Zielgruppe Software Entwickler und ge bte BS2000 OSD Benutzer U5461 J Z135 6 383 Literatur DCAM BS2000 OSD TRANSDATA COBOL Aufrufe Benutzerhandbuch Zielgruppe Programmierer von DCAM COBOL Programmen DCAM BS2000 OSD TRANSDATA Makroaufrufe Benutzerhandbuch Zielgruppe Programmierer von DCAM Assembler Programmen DCAM BS2000 OSD TRANSDATA Programmschnittstellen Beschreibung Zielgruppe Organisatoren Einsatzplaner Programmierer Systemverwalter und Netzadministratoren FHS BS2000 OSD TRANSDATA Formatierungssystem f r openUTM TIAM DCAM Benutzerhandbuch Zielgruppe Programmierer IFG fur FHS TRANSDATA Benutzerhandbuch Zielgruppe Datenstationsbenutzer Anwendungsdesigner und Programmierer FHS DOORS BS2000 OSD MS Windows Grafische Oberfl che f r BS2000 OSD Anwendungen Benutzerhandbuch Zielgruppe End Anwender von FHS
387. uktumfeld 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 Die Adapter Familie BeanConnect geh rt zur Produkt Suite openSEAS open Suite for En terprise Application Servers Die BeanConnect Adapter realisieren die Verkn pfung zwi schen klassischen Transaktionsmonitoren und modernen Application Servern und erm g lichen damit die effiziente Integration von Legacy Anwendungen in moderne Java Anwendungen e Das Handbuch BeanConnect for openUTM beschreibt das Produkt BeanConnect for openUTM BeanConnect for openUTM bietet einen JCA 1 5 konformen Adapter der UTM Anwendungen mit Anwendungen auf Basis von J2EE z B dem Oracle Applica tion Server Oracle AS 10g verbindet Die Handb cher zu Oracle AS 10g sind bei Oracle beziehbar e Das Handbuch BeanConnect for CICS beschreibt das Produkt BeanConnect for CICS BeanConnect for CICS bietet einen JCA 1 5 konformen Adapter der CICS An wendungen mit Anwendungen auf Basis von J2EE z B dem Oracle Application Server verbindet Web Anbindung und Anwendungsintegration Zum AnschlieBen neuer und bestehender UTM Anwendungen an das Web mit dem Pro dukt WebTransactions ben tigen Sie die folgenden Handb cher e Das einf hrende Handbuch WebTransactions Konze
388. ul KCOCOHF Funktion PrepareCtrlReq Der Makro mGetBufferSpace lieferte den Returncode LB_NOMEM POLLO3 XM Modul KCOXFPL Funktion ap_poll Der Returncode des Makros mGetBufferSpace war ungleich LB_OK RCV009 XM Modul KCOXFRY Funktion ap_rcv Der Returncode der Funktion CopyElement war ungleich DM_OK RCV012 XM Modul KCOXFRV Funktion ap_rcv Inkonsistenz in den booleschen Variablen lt bSwitchToNextTtnid gt und lt bClearTtnid gt RQOBOO M Modul KCOCOHF Funktion RegOssiInBuff Die Funktion RequestBuffer lieferte den Returncode LB_NOMEM RVCAO1 XA Modul KCOXFRV Funktion CopyVarLthAttr Die Funktion AllocUserMem lieferte einen unerwarteten Returncode RVCS03 M Modul KCOXFRV Funktion CheckSaRetc Der von der Funktion SetAttribute gelieferte Returncode war SA_NOMEM RVUOO1 XS Modul KCOXFRV Funktion UserDataOut In der multitasking Variante reichen die von UTM zur Verf gung gestell ten Buffer zur Aufnahme der User Daten nicht aus um alle User Daten zu Ubergeben 272 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen des Programms u62_tp REASON Grp Ursache SACT14 XM Ung ltiger Returncode nach Aufruf von PutElement zum Anfordern eines dynamischen Speicherbereichs f r SACF Aktion COPY SDCS02 Modul KCOXFSD Funktion CheckSaRetc Der SetAttribute Returncode war SA_NOMEM SDUIO1 Modul KCOXFSD
389. und der OSI TP Dialog beendet 70 U5461 J Z135 6 LU6 2 Kopplungen mit openUTM LU62 openUTM LU62 administrieren Aufruf einer UTM Transaktion durch ein CICS Anwendungsprogramm RECEIVE_ALLOCATE tpid 00133014 gt 10 47 45 line 5489 corr 2 tp_name UCS1 sync_level SYNCPT conv_type MAPPED_CONVERSATION Ein CICS Anwendungsprogramm wurde gestartet und will eine Verbindung zu einem UTM Anwendungsprogramm mit dem Transaktionscode UCS1 aufbauen APM_ALLOCATE_REQ fd 1 10 47 45 line 5615 corr 2 gt APM_ALLOCATE_CNF fd 1 10 47 45 line 5687 corr 2 lt TP_BEGIN_DIALOGUE_REQ fd 1 10 47 45 line 5848 corr 2 gt udata_len 28 openUTM LU62 baut eine Verbindung zum gew nschten UTM Anwendungsprogramm auf MC_RECEIVE_IMMEDIATE tpid 00133014 gt 10 47 45 line 5975 corr 2 what_rcvd DATA_COMPLETE len 2 Das CICS Anwendungsprogramm sendet 2 byte Daten TP_DATA_REQ fd 1 10 47 45 line 6005 corr 2 gt udata_len 23 openUTM LU62 sendet die Daten an das UTM Anwendungsprogramm weiter Hier sieht man dass openUTM LU62 einen OSI TP Header von 21 byte voransetzt MC_RECEIVE_IMMEDIATE tpid 00133014 gt 10 47 45 line 6135 corr 2 what_rcvd PS_HEADER_COMPLETE Request Commit MC_RECEIVE_AND_POST tpid 00133014 gt 10 47 45 line 6197 corr 2 what_rcvd SEND U5461 J Z135 6 71 openUTM LU62 adm
390. ung saaa aa aaa eee eae 150 U5461 J Z135 6 Inhalt 4 3 Verwendung der Programmschnittstelle CPI C 2222222 151 4 3 1 Vergleich mit KDCS Aufrufen 2 2 a 151 4 3 2 Beispiele f r openUTM CPI C Kommunikation aoaaa a 154 Start eines openUTM Dialogvorgangs aus einem CPI C Anwendungsprogramm 154 Start eines UTM Asynchron Vorgangs aus einem CPI C Anwendungsprogramm 160 Start eines CPI C Dialogvorgangs aus einem UTM Anwendungsprogramm 162 Start eines CPIC Asynchron Vorgangs aus einem UTM Anwendungsprogramm 175 5 openUTM IMS Kopplung ber LU6 2 2 2 nn nenn 177 5 1 openUTM IMS Kopplung generieren 222 una nenn 177 5 1 1 IMS Startup Parameter lt u aca ba SER un ea ann EE 177 612 Definition des LU Namens von IMS 2 2 2 Emma ee ee 178 5 1 3 Definition von IMS Transaktionen aoaaa a re 179 5 1 4 Definition von Partner LU und open UTM Transaktionen 180 5 1 5 VTAM Generierung aoaaa a 181 5 1 6 LOG SCO os a Se Ae eee oe hoe a be ee ee 183 51 7 Vollst ndiges Generierungsbeispiel ee 183 5 2 openUTM IMS Kopplung programmieren 02 0 25082 eae 194 5 251 Programmschnittstelle DL I ee ee eo eee eee ee ra 194 5 2 2 Programmschnitisiella GPIO 3 2 sae hb SA ee an 8 1 OREN as a OM 197 5 2 3 LUG 2 E EXIFAGUING 2 4608 near heart 197 5 2 4 Benutzung von Formatnamen aaau a a a 197 5 2 5 Ablauf Beispiele mit DL I Programmen
391. ung der Instanz von openUTM LU62 veranlasst amp REASON gibt genaueren Aufschluss ber die Fehlerursache Die Spalte Grp Gruppe in der folgenden Tabelle beschreibt welcher Ursachen gruppe der Abbruch angeh rt Es gibt folgende Gruppen A Ursache ist ein Anwenderfehler z B ein Fehler beim Generieren und administrieren von openUTM LU62 Generieren des System z B Aufteilung des Adressraums S Ursache ist ein Fehler in einer anderen Systemkomponente Software oder Hardware M Ursache ist ein Speicherengpass x Ursache ist ein interner Fehler von openUTM LU62 Mehrfachnennungen sind m glich z B XAS Bei allen Fehlern der Gruppen S und X und bei allen nicht in der folgenden Tabelle aufgelisteten Fehlercodes sollten Sie zur Kl rung den Siemens Systemdienst her anziehen Sichern Sie den Inhalt des Dateiverzeichnisses opt 1ib utm 1u62 PROT UNIX Systeme bzw Programme utm1u62 PROT Windows Systeme Wenn m g lich sollten Sie den Fehlerfall mit eingeschaltetem XAP TP Trace nachstellen REASON Grp Ursache AHQA00 XM Modul KCOCOTA Funktion QueueAnno Der Makro mGetBufferSpace lieferte den Returncode LB_NOREM ASA001 XA Der Modul KCOASAM wurde mit einem ung ltigen Operationscode auf gerufen ASA002 XA Der Modul KCOASAM wurde mit dem Operationscode ASAM_SET_ACCPTS aufgerufen Die mitgegebene Anzahl an access points ist gr er als die Zahl der generierten 268 U5461
392. ung des Associationsaufbaus mit einem Application Context Namen antwortet der nicht mit dem in der lokalen An wendung f r diesen Partner konfigurierten Application Context Namen berein stimmt Die Inserts haben folgende Bedeutung amp ACPNT Name des lokalen ACCESS POINT amp OSLPAP Name des Partners in der lokalen Anwendung amp XPOOBID amp XP9OBID sind die maximal zehn Elemente des Objektbezeichners die den Application Context Namen des fernen Partners bilden F r nicht belegte Elemente wird 7 ausgegeben CMX Diagnoseinformation amp XPCTYPE amp XPCCLS amp XPCVAL Diese Meldung wird ausgegeben wenn eine vorhergehende Meldung aufgrund eines vom Transportsystem gemeldeten Fehlers ausgegeben wurde Es wird der Diagnosecode des Transportsystems aufbereitet In den folgenden Tabellen wer den einige Werte fur amp XPCTYPE amp XPCCLS und amp XPCVAL beschrieben Eine voll st ndige Auflistung enth lt die zu CMX geh rende Include Datei cmx h XPCTYPE Bedeutung CMX Fehlertyp 0 T_CMXTYPE CMX Fehler der von der CMX Bibliothek erkannt wurde 2 T_DSTEMPERR Tempor rer TNS Fehler 3 T_DSCALL_ERR TNS Aufruffehler 4 T_DSPERM_ERR Permanenter TNS Fehler 5 T_DSWARNING TNS Warnung gt 15 CMX Fehler aufgrund von Fehlercodes aus dem Transportsystem 320 U5461 J Z135 6 Meldungen von open UTM LU62 Meldungen des XAP TP Providers XPCCLS Bedeutung CMX Fehlerklasse g ltig f
393. von Optionen moeglich durch Komma getrennt IN lt Level gt mit Instanz Trace XAP mit XAP TP Provider Trace Zum De Registrieren von openUTM LU62 als Dienst u62_start r lt LU Name gt zum Registrieren u62_start u lt LU Name gt zum Deregistrieren u62_start wurde mit falschen Schaltern oder Parametern aufgerufen openUTM LU62 wird nicht gestartet Service amp SERVICENAME erfolgreich gestartet Diese Meldung wird beim Start von openUTM LU62 auf Windows Systemen aus gegeben Fehler beim Starten des Service amp SERVICENAME Funktion amp FUNKNAME Fehlercode amp ERRNO amp ERRTEXT Werden auf Windows Systemen eine oder mehrere openUTM LU62 Instanzen di rekt aus der Kommandozeile gestartet so wird f r jede gestartete Instanz gegebe nenfalls zun chst ein System Dienst mit dem Namen amp SERVICENAME eingerich tet und gestartet Kann der System Dienst nicht gestartet werden so erscheint die Meldung 43 wobei amp FUNKNAME der Name der fehlgeschlagenen Systemfunktion OpenSCManager OpenService StartService ist und ERRNO und amp ERRTEXT den Fehlercode angeben 348 U5461 J Z135 6 Meldungen von openUTM LU62 Meldungen von u62_sta 10 3 2 Meldungen von u62_sta 02 03 04 05 06 07 08 09 10 Aufruf u62_sta lt LU Name gt b u62_sta c b Fehler beim Erzeugen der Input Pipe amp PIPEFILE errno amp ERRNO amp ERRTEXT Fehler beim Oeffnen der Input Pipe amp
394. w ist ung ltig 49Z Parameterfelder die von diesem Aufruf nicht verwendet werden sind nicht auf bin r null gel scht 71Z Indem UTM Anwendungsprogrammlauf wurde noch kein INIT gegeben Nach einem erfolgreichen INFO GN k nnen die im Datenbereich lt parm2 gt enthaltenen Werte benutzt werden um dem Partnerprogramm in CICS oder IMS eine Antwort zu schik ken Das Partnerprogramm muss dann mit APRO IN und Leerzeichen in KCRN adressiert werden siehe unten 252 U5461 J Z135 6 LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen Programmschnittstelle f r openUTM APRO IN Die folgende Tabelle zeigt die notwendigen Angaben im KDCS Parameterbereich bei APRO IN KCOP KCOM KCLM KCRN KCPA KCPI APRO IN 32 LTAC name LPAP name Vorgangs Identifikation oder SPACES Leerzeichen LPAP Name Alle anderen Parameterfelder m ssen auf bin r null gesetzt werden Im Datenbereich m ssen alle Felder belegt werden Leerzeichen bedeutet dass der Name nicht angegeben wurde Enth lt ein Feld im Datenbereich nicht Leerzeichen so wird es von openUTM als g ltiger Name akzeptiert Es wird keine Pr fung durchgef hrt ob ein Feld nur alphanumerische Zeichen enth lt oder ob z B KCRDPN KCRPRN ein Ziel in der lokalen Anwendung ist F r die Adressierung des Auftragnehmers mit APRO IN gibt es folgende M glichkeiten 1 Adressierung durch KCRN LTAC wie beim APRO AM In diesem Fall m ssen KCDPN und KCPRN Leer
395. war dann Start des Folgeprogramms zu diesem Sicherungspunkt INIT KCKNZVG R MGET NT KCRN gt A VGST 0 TAST R U5461 J Z135 6 139 openUTM CICS Kopplung programmieren openUTM CICS Kopplung ber LU6 2 18 CICS Anwendungsprogramm setzt Transaktion zur ck und bricht Vorgang ab zweite Variante gt INIT MGET Client APRO DM KCPI gt A KCOF C MPUT NE KCRN gt A PGWT KP PMH5 Daten gt RECEIVE STATE SEND SYNCPOINT ROLLBACK ISSUE ABEND RETURN lt FMH7 FMH7 Response gt KCTARB Y MGET NT KCRN gt A VGST T TAST R MPUT Client PEND KCOM FR Im Gegensatz zu Beispiel 17 erh lt das Teilprogramm im Beispiel 18 nach dem R cksetzen durch CICS eine R ckmeldung zur Kontrolle 140 U5461 J Z135 6 openUTM CICS Kopplung ber LU6 2 openUTM CICS Kopplung programmieren 19 CICS Anwendungsprogramm setzt Transaktion zur ck Vorgang l uft weiter gt INIT MGET APRO MPUT PEND Client DM KCPI gt A KCOF C NE KCRN gt A KP INIT MGET NT KCRN gt A VGST 0 TAST 0 MPUT NE KCRN gt A KCLM 0 CTRL PR KCRN gt A PEND KP INIT MGET NT KCRN gt A VGST 0 TAST P MPUT NE Client PEND RE INIT MGET MPUT CTRL PEND Client NE KCRN gt A PE KCRN gt A KP lt K034 Mel dung gt lt FMH5 Daten gt RECEIVE STATE SEND SEND Daten Prepare gt gt RECEIVE STATE SYNCRECEIVE SYNCPOINT Req
396. werkname im SNA Netz amp NETNAME hat beim Austausch der Log Namen einen schwerwiegenden Fehler vermutlich einen warm kalt Fehler festgestellt Ab diesem Zeitpunkt sind keine Conversations mit Sync Level 2 mehr m glich In der Regel hilft in diesem Fall nur das administrative Beenden aller noch bestehenden Transaktionen Logical Units of Work beim LU6 2 Partner oder gleich ein Kaltstart des Partners Beachten Sie jedoch dass dabei Datenbank Inkonsi stenzen entstehen k nnen Aktiver Aufbau einer Conversation zum Resync TP X 06F2 fehlgeschlagen Allokationsfehler Code amp ERRTXT Im Moment l sst sich keine Conversation zum Resync TP des LU6 2 Partners aktiv aufbauen so dass kein Austausch der Log Namen und kein Abgleich von Transak tionszust nden m glich ist Der Fehlercode amp ERRTXT enth lt dann im Klartext den Returncode des entsprechenden LU6 2 Aufrufs openUTM LU62 weist auch hier alle auf das Ergebnis des Austausches der Log Namen wartenden OSI TP Dialoge mit Functional Unit Commit zur ck wiederholt den Austausch aber bei der n ch sten Gelegenheit Aktiver Aufbau einer Conversation zum Resync TP X 06F2 fehlgeschlagen Inkonsistenz in den Konfigurationen von openUTM LU62 und der LU6 2 Basis Software LOC_LU_ALIAS REM_LU_ALIAS Aufgrund der Inkonsistenz der Konfigurierungen der LU6 2 Basis Software z B TRANSIT und openUTM LU62 sind derzeit berhaupt keine Conversations zwi schen open UTM LU62 und dem LU6
397. x System ein Windows System oder ein anderes UNIX System sein Als Gateway Rechner wird ein Solaris System ben tigt UNIX System BS2000 OSD oder Windows System IBM Rechner CICS oder IMS openUTM oder TXSeries CMX PCMX bzw BCAM SNA Basis Software z B VTAM Solaris Rechner CMX openUTM LU62 SNAP IX Enterprise Extender SNA uber IP LU6 2 Kopplung Uber Gateway Rechner mit SNAP IX auf Solaris Im Falle von openUTM unter BS2000 OSD ist zus tzlich das Produkt OSS BS2000 OSD erforderlich Die Verbindung zwischen den beiden linken Rechnern erfolgt Uber TCP IP mit RFC1006 Im Bild ist eine SNA Kopplung Uber Enterprise Extender SNA uber IP dargestellt Zu an deren Kopplungsm glichkeiten siehe die Dokumentation zu SNAP IX 30 U5461 J Z135 6 Kopplung mit IBM Systemen LU6 2 Kopplung ber Gateway mit IBM Communications Server 2 7 LU6 2 Kopplung ber Gateway Rechner mit IBM Communications Server auf Linux oder AIX Systemen Die folgende Kopplungsm glichkeit ber LU6 2 kann immer dann eingesetzt werden wenn der Rechner auf dem die UTM Anwendung l uft nicht direkt an das SNA Netz angebun den werden soll oder kann Das Betriebssystem dieses Rechners ist beliebig Es kann z B ein BS2000 OSD ein Solaris oder Linux System ein Windows System oder ein anderes UNIX System sein Als Gateway Rechner wird ein Linux bzw AIX System ben tigt UNIX Sys
398. zeichen enthalten 2 Adressierung durch KCDPN und KCPRN KCRN muss Leerzeichen enthalten KCPA den LPAP Namen Diese Art der Adressie rung ist nach einem erfolgreichen INFO GN sinnvoll 3 Adressierung durch die Nachricht KCRN KCDPN und KCPRN enthalten Leerzeichen KCPA enth lt den LPAP Namen Die ersten 8 Zeichen beim FPUT DPUT enthalten den Transaktionscode COBOL Format des Aufrufs CALL KDCS USING lt parml gt lt parm2 gt lt parm1 gt KDCS Parameterbereich lt parm2 gt Datenbereich U5461 J Z135 6 253 Programmschnittstelle f r openUTM LU6 1 Pseudo Dialoge zwischen Asynchron Vorg ngen R ckgaben von openUTM Das R ckgabefeld KCRCCC kann neben den im Handbuch openUTM Anwendungen pro grammieren mit KDCS f r COBOL C und C beschriebenen Returncodes einen der fol genden Werte enthalten 44Z Bei der Adressierung ber KCDPN und oder KCPRN enth lt KCRN nicht Leerzei chen KCRCDC enth lt KD21 47Z Die Adresse des Datenbereichs fehlt bzw ist ung ltig 49Z Parameterfelder die von diesem Aufruf nicht verwendet werden sind nicht ge l scht Erfolgt die Adressierung nicht ber KCRN so werden DPN und PRN im Ausgabe FMH von openUTM mit den Werten aus dem Datenbereich versorgt Die Generierung von DPN bei der SESCHA Anweisung wird nicht ber cksichtigt Mit dem Aufruf APRO IN gehen Datenschutzfunktionen verloren falls die Adressie rung nicht mit KCRN erfolgt F r den Datenbereich gibt es
399. zugeh rigen OSI LPAP Anweisung in der UTM Anwendung entsprechen M gliche Werte sind UDTCCR UDTSEC UDTAC UDTDISAC Diese Werte haben dieselbe Bedeutung wie bei openUTM Standardwert ist UDTSEC Wenn UDTSEC nicht verwendet wird ist es nicht m glich Benutzerkennung und eventuell Passwort beim Conversation Aufbau zu benutzen Bei UDTAC oder UDTDISAC arbeitet openUTM LU62 ohne Transaktionssicherung ASSOCIATIONS ass_number Maximale Anzahl paralleler Verbindungen zwischen open UTM LU62 und UTM An wendung Der Wert sollte dem Wert des ASSOCIATIONS Parameter aus der zuge h rigen OSI LPAP Anweisung in der UTM Generierung entsprechen Wenn TRANSIT SERVER verwendet wird sollte er auch mit dem Wert von SESS MAX in der XMODE Anweisung von TRANSIT SERVER bereinstimmen Wenn SNAP IX oder der IBM Communications Server verwendet wird sollte er mit dem Session Limit in der Mode Definition bereinstimmen Minimalwert 1 Standardwert 1 Maximalwert 254 U5461 J Z135 6 45 openUTM LU62 generieren LU6 2 Kopplungen mit openUTM LU62 CONNECT conn_number Anzahl der Verbindungen zur UTM Anwendung die beim Start einer openUTM LU62 Instanz automatisch aufgebaut werden sollen Zul ssige Werte sind ganze Zahlen von 0 bis ass_number Der Standardwert ist 0 Kann openUTM LU62 die gew nschte Anzahl von Verbindungen beim Start nicht aufbauen erfolgt alle 5 Minuten ein neuer Versuch Der CONNECT Parameter wirkt ber den ganzen L
400. zur Partner LU u62_adm as Da dieser Fehler damit nur tempor rer Natur ist werden zwar alle OSI TP Dialoge mit Functional Unit Commit die auf das Ende des Austausches der Log Namen warten abgelehnt Beim Eintreffen des n chsten OSI TP Dialogs mit Functional Unit Commit wird allerdings der Austausch der Log Namen erneut angesto en Sie m ssen also nach Behebung des Leitungsproblems openUTM LU62 nicht wieder neu starten Weitere Meldungen der Komponente BD auf Windows Systemen 900 901 902 903 904 905 Fehler beim Oeffnen des Listener Sockets errno amp ERRNO amp ERRTEXT Jede Instanz von openUTM LU62 richtet beim Start einen Listener Socket ein um ankommende Verbindungsw nsche von den Administrationsprogrammen entge genzunehmen Geht die Systemfunktion socket schief wird diese Meldung aus gegeben und die Instanz beendet sich Fehler beim Binden des Listener Sockets an Port errno amp ERRNO amp ERRTEXT F r openUTM LU62 ist kein freier Port gt 5000 verf gbar Die Instanz beendet sich nach der Ausgabe dieser Fehlermeldung Fehler beim Erzeugen der Port Datei amp PORTFILE errno amp ERRNO amp ERRTEXT Fehler beim Schreiben in die Port Datei amp PORTFILE errno amp ERRNO amp ERRTEXT Fehler beim Schreiben in die Port Datei amp PORTFILE geschrieben amp ANZ1 Bytes erwartet amp ANZ2 Bytes Beim Erzeugen oder beim Beschreiben der Datei amp PORTFILE die in bin rer Form den Port des Li

und LU6.2-Anwendungen - Fujitsu manual server

Contents

Download Pdf Manuals

Related Search

Related Contents