CallAPI für VMS installieren

CallAPIs installieren

CallAPI für Windows installieren

---

CallAPI für VSE installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines CallAPI für VSE.

Für die Nutzung des CallAPI für VSE ist TCP/IP for VSE eine zwingende Voraussetzung. Die Kommunikation zur Automation Engine erfolgt über TCP/IP-Sockets. Die Konfiguration muss eine Verbindung zur Automation Engine erlauben, d.h. IP-Adresse und Portnummer der Automation Engine müssen von VSE ansprechbar sein.

Ausgelieferte Dateien

Ablauf

Die in der Auslieferung enthaltene INI-Datei kann bereits auf die für die Installation richtigen Werte angepasst werden.

Es ist nicht nötig, die INI-Datei bei jeder neuen Automation Engine-Version zu übernehmen. Achten Sie lediglich darauf, ob in der INI-Datei etwas geändert werden muss. Informationen dazu finden Sie in den ReleaseNotes, die sich gesammelt im Handbuch Änderungshistorie befinden.

Zuerst muss im VSE eine Bibliothek angelegt werden. In der weiteren Beschreibung wird diese "PRD2.UC4" genannt. Dieser Name kann selbstverständlich frei gewählt werden. Die Bibliothek kann über einen Job durch das Dienstprogramm LIBR erzeugt werden:

* $$ JOB JNM=CREATE,CLASS=A,DISP=D
* $$ LST CLASS=A,DISP=D
// JOB CREATE
// EXEC LIBR
DEFINE SUB=PRD2.UC4
/*
/&
* $$ EOJ

Als nächster Schritt sind die Dateien auf das VSE-Betriebssystem zu übertragen. Dies kann mit IND$FILE oder falls auf der VSE-Maschine vorhanden mit FTP erfolgen.

In Fällen, in denen kein IND$FILE möglich und kein FTP vorhanden ist, muss das Programm über die Punchdatei ucxbvse.punch erzeugt werden.

Übertragung mit IND$FILE

Viele 3270 Emulation unterstützen die Filetransfermethode IND$FILE. In der IBM Emulation gibt es z.B. die Konsol-Dienstprogramme SEND und RECEIVE. Für diese Art von FileTransfer muss auf dem VSE IND$FILE installiert sein. Dies kann wie folgt überprüft werden:

1. Auf VSE in CICS anmelden
2. CICS Bildschirm löschen (Taste F9 = Escape)
3. IND$ eingeben

Wenn jetzt keine Fehlermeldung erscheint, ist IND$FILE installiert. Mit F3 (Beenden Transaktion IND$) und F3 (Zurück zu CICS Menü) kommen Sie wieder zurück.

Wenn man die Übertragung durchführen möchte, muss man sich mit der 3270 Emulation wieder auf dem gelöschten CICS Bildschirm befinden. Ist dies aus Berechtigungsgründen nicht erlaubt, besteht noch die Möglichkeit, über den Menüpunkt 3 (Operations), 8 (Personal Computer Move Utilities) und 6 (PC FileTransfer) in einen Übertragungsmodus zu gelangen.

Jetzt auf dem PC in ein Konsolfenster (CMD starten) wechseln, und die drei Dateien mit dem SEND Kommando übertragen:

send ucx.msl     b: ucx     msl   (FILE=LIB L=PRD2 S=UC4
send ucxbvse.ini b: ucxbvse ini   (FILE=LIB L=PRD2 S=UC4
send ucxbvse.bin b: ucxbvse phase (FILE=LIB L=PRD2 S=UC4 binary

In diesem Beispiel war das Emulation "B" für die Übertragung bereit.

Alternativ dazu kann die Phase auch aus der PUNCH-Datei erstellt werden. Dazu muss anstelle der Datei "ucxbvse.bin" folgende Datei übertragen werden:

send ucxbvse.punch b: ucxbvse (FILE=PUN binary LRECL=80

Nach erfolgreicher Übertragung der PUNCH-Datei in der Emulation über Menüpunkt 3 (Operations) und Menüpunkt 2 (Manage Batch Queues) in die Punch Queue (Auswahl 3) wechseln. Hier "UCXBVSE" mit 4 (Copy to Primary Library) kopieren. Wenn das Kopieren erfolgreich war, kann "UCXBVSE" aus der Punch Queue gelöscht werden.
Jetzt zurück zum Hauptmenü, und mit Menüpunkt 5 (Program Development) und 1 (Program Development Library) in die Primary Library wechseln. Die Datei "UCXBVSE" zum editieren öffnen. Jetzt am Anfang der Datei folgende JCL Zeilen einfügen:

* $$ JOB JNM=CATAL,CLASS=A,DISP=D
* $$ LST CLASS=A,DISP=D
// JOB CATAL
// OPTION CATAL
// LIBDEF *,CATALOG=PRD2.UC4
INCLUDE

Dann am Dateiende folgende JCL Zeilen anhängen:

// EXEC LNKEDT
/*
/&
* $$ EOJ

Die geänderte Datei speichern und den damit erstellten Job mit 7 (Submit) starten. Wenn der Job erfolgreich durchgeführt wurde, sollte dann die Phase "UCXBVSE.PHASE" in der Bibliothek "PRD2.UC4" vorhanden sein.

Übertragung mit FTP

Für die Übertragung der Datei über FTP ist ein installierter FTP-Server auf dem VSE notwendig. Dazu auf dem PC in ein Konsolfenster wechseln und die Dateien per FTP-Client zum VSE übertragen:

ftp vse.mycompany.com
cd PRD2
cd UC4
put ucx.msl
put ucx.bvse.ini
bin
put ucxbvse.bin ucxbvse.phase
quit

Verwendung

Zuerst INI-Datei anpassen, sofern dies nicht schon am PC durchgeführt worden ist. Dazu mit der 3270 Emulation an CICS anmelden und mit F9 in einen leeren CICS Bildschirm wechseln. DITTO eingeben und über Punkt 5 (Work with VSE libraries) und 2 (List directory) zur "LDL - Library Directory List" Maske wechseln. Die Bibliothek PRD2.UC4 eingeben und weiter. Mit dem Cursor auf das Member "UCXBVSE INI" gehen und die F4 Taste drücken. Mit Menüpunkt 4 kann jetzt das Member editiert werden.

Es sind die Serverdaten der Installation (Sektion Server) einzutragen. Falls gewünscht kann in der USER-Sektion ein Standardbenutzer für das CallAPI eingetragen werden.

Siehe auch:

CallAPI für VSE