Initialisierungsparameter und UTM-Generierung

Ein XATMI-Client wird mit der Funktion tpinit() initialisiert. In der Struktur TPCLTINIT werden Parameter für Benutzerkennung, Kennwort und für den lokalen Anwendungsnamen übergeben. Diese Parameter müssen wie folgt mit der UTM-Generierung abgestimmt sein.

Benutzerkennung und Kennwort

Bild 22: Abstimmung der Generierungsparameter

Für die beim Aufruf tpinit() übergebene Benutzerkennung user muss in der UTM-Anwendung mit einer USER-Anweisung eine entsprechende UTM-Benutzrekennung generiert sein. Anhand der übergebenen Zugangsdaten user und ggf. password
prüft UTM die Zugangsberechtigung.

Lokaler Anwendungsname

Das folgende Bild zeigt die Initialisierung für den Fall, dass in der upicfile ein lokaler Anwendungsname definiert ist.

Bild 23: Initialisierung einer lokalen Anwendung

Ist ein lokaler Anwendungsname in der upicfile generiert, dann kann dieser Name beim tpinit() angegeben werden, in diesem Beispiel client. Der zugehörige Anwendungsname muss dann mit dem in der PTERM-Anweisung bzw. bei OSI-CON TSEL= angegebenen Namen übereinstimmen.

Ist kein lokaler Anwendungsname in der upicfile generiert, dann muss der Name angegeben werden, der auf UTM-Seite in der PTERM-Anweisung definiert ist (in diesem Beispiel upicclt) oder es ist ein für Upic geeigneter TPOOL generiert .

Beispiel

Das folgende Beispiel umfasst als Auszug alle relevanten Teile von Local Configuration, UPIC-Konfigurierung, Initialisierung und KDCDEF-Generierung.

1. Client

   Local Configuration:

   SVCU ...
        ,RSN=SERVICE1
        ,TAC=TAC1
        ,DEST=SATURNUS
         ...
   

   upicfile:

   SDSATURNUS utmserv1

   


   Initialisierung

   TPCLTINIT tpinfo;
   strcpy (tpinfo.cltname, "CLIENT1");
   strcpy (tpinfo.usrname, "UPICUSER");
   strcpy (tpinfo.passwd, "SECRET");
   tpinit (tpinfo);
   

2. Server

   Local Configuration

   SVCP SERVICE1 ... (auch REQP möglich)
        ,TAC=TAC1
   
   KDCDEF-Anweisungen
   
   MAX APPLINAME=UTMSERV1 (im BS200 eigener BCAMAPPL nötig)

   siehe Handbuch "Anwendungen erstellen mit X/Open-Schnittstellen"
   oder

   BCAMAPPL UTMSERV1 (auf BS2000-Systemen zusätzlich mit Parameter TPROT=ISO)
   LTERM UPICTERM 
   PTERM TNSCLIENT, PTYPE=UPIC-R, PRONAM=DxxxSyyy (bei UPIC-Remote-Kopplung)
   PTERM CLIENT1, PTYPE=UPIC-L                    (bei UPIC-Local-Kopplung)
   TAC TAC1, PROGRAM=..., API=(XOPEN,XATMI)
   USER UPICUSER,PASS=SECRET