Datenstrukturen für C/C++-Teilprogramme

Um die Datenbereiche zu strukturieren, werden mit openUTM folgende Include-Dateien (Header-Files) ausgeliefert, die vordefinierte Datenstrukturen enthalten:

Auf BS2000-Systemen sind die Datenstrukturen in der Bibliothek SYSLIB.UTM.070.C enthalten.

Auf Unix-, Linux und Windows-Systemen sind die Datenstrukturen im Verzeichnis include im UTM-Verzeichnis utmpfad enthalten.

Name	Inhalt und Bedeutung
kcapro.h	optionaler zweiter Parameterbereich für den APRO-Aufruf: Dieser Bereich dient zur Auswahl spezieller OSI TP-Funktionskombinationen und des Security-Typs. kcapro.h wird durch kcmac.h abgesetzt.
kcat.h	KDCS-Attributfunktionen (nur auf BS2000-Systemen): Bei Verwendung von +Formaten können Sie mit den symbolischen Namen für Attributfunktionen die Attributfelder Formate verändern.
kcca.h	Datenstruktur für den KDCS-Kommunikationsbereich (communication area); dieser enthält: aktuelle Daten des Vorgangs und Programms, Rückgaben nach einem Aufruf an openUTM und falls gewünscht den KB-Programmbereich zur Datenübergabe zwischen Programmen in einem Vorgang. Die Felder des KB-Programmbereichs müssen Sie zusätzlich definieren. kcca.h wird durch kcmac.h abgesetzt.
kccf.h	Nur auf BS2000-Systemen: definiert den zweiten Parameter, den openUTM beim Event-Exit INPUT übergibt. In diesem Parameter übergibt openUTM die Inhalte der Steuerfelder von Bildschirmformaten an das Teilprogramm. Dieser zweite Parameter wird deshalb auch Steuerfeldbereich (Control Fields) genannt.
kcdad.h	Datenstruktur für den DADM-Aufruf: Diese Datenstruktur sollten Sie beim KDCS-Aufruf DADM RQ über den Nachrichtenbereich legen.
kcdf.h	KDCS-Bildschirmfunktionen: Mit diesen symbolischen Namen können Sie die Bildschirmausgabe beeinflussen, indem Sie den Namen der gewünschten Funktion ins Feld KCDF des KDCS-Parameterbereiches bringen. kcdf.h wird durch kcmac.h abgesetzt.
kcinf.h	Datenstruktur für den INFO-Aufruf: Diese Datenstruktur sollten Sie beim KDCS-Aufruf INFO DT/SI/PC über den Nachrichtenbereich legen.
kcini.h	definiert einen zweiten Parameterbereich für den INIT-Aufruf (nur notwendig bei INIT PU): In diesen Parameterbereich liefert openUTM die mit dem INIT PU-Aufruf angeforderten Informationen zurück.
kcinp.h	Datenstruktur für den INPUT-Exit: Diese Datenstruktur enthält die Eingabe- und Ausgabeparameter des INPUT-Exits.
kcmac.h	KDCS-Makro-Schnittstelle für C/C++: Diese Datei enthält alle Makros der C/C++-Makro-Schnittstelle sowie die Include-Anweisungen für die Include-Dateien kcapro.h, kcca.h, kcdf.h und kcpa.h.
kcmsg.h	Datenstruktur für die UTM-Meldungen: Diese Datenstruktur benötigen Sie, wenn Sie Meldungen in einer MSGTAC-Routine behandeln oder wenn Sie die SYSLOG-Datei mit einem eigenen Programm auswerten wollen.
kcpa.h	Datenstruktur für den KDCS-Parameterbereich: Dieser Bereich nimmt die Parameter eines KDCS-Aufrufs auf. kcpa.h wird durch kcmac.h abgesetzt.
kcpad.h	Datenstruktur für den PADM-Aufruf: Diese Datenstruktur sollten Sie beim KDCS-Aufruf PADM AI/PI über den Nachrichtenbereich legen.
kcsgst.h	Datenstruktur für den SIGN-Aufruf: Diese Datenstruktur sollten Sie beim KDCS-Aufruf SIGN ST mit KCLA > 0 über den Nachrichtenbereich legen.

Diejenigen Datenstrukturen, die Sie verwenden, fügen Sie vor dem Aufruf des Teilprogramms per #include ein. Im Teilprogramm müssen Sie die entsprechenden Bereiche (Kommunikationsbereich, KDCS-Parameterbereich,...) explizit deklarieren.

Beispiel 3

/* Konstanten und Datenstrukturen einfügen */
#include <kcmac.h>                        /* UTM-Datenstrukturen        */
#include <kcinf.h>
   struct ca_area {...};
   struct work
    { union kc_paa param; 
      struct msg_area
       { struct kc_dttm   info_time;      /* Bereich fuer INFO DT       */
         struct kc_sysinf info_sys;       /* Bereich fuer INFO SI       */
         char text[200];
       } msg_a;
    };
void cprog (struct ca_area *ca, struct work *spab)