Data structures for C/C++ program units

In order to structure the data areas, the following header files containing predefined data structures are supplied with openUTM.

On BS2000 systems, the data structures are present in the library SYSLIB.UTM.070.C.

On Unix, Linux and Windows systems, the data structures are present in the include directory in the UTM directory utmpath.

Name	Contents and meaning
kcapro.h	Optional second parameter area for the APRO call: This area is used to select special combinations of OSI TP functions and the type of security. kcapro.h is included by kcmac.h.
kcat.h	KDCS attribute functions (only on BS2000 systems): When using +formats, you can change the attribute field formats with the symbolic names for attribute functions.
kcca.h	The data structure for the KDCS communication area; this area contains: current service and program data, return data from a UTM call and if desired, the communication area program area for passing data between programs in a service. You must also define the fields of the communication area program area. kcca.h is included by kcmac.h.
kccf.h	Only on BS2000 systems: Defines the second parameter passed by openUTM during the INPUT event exit. In this parameter openUTM passes the contents of the control fields of screen formats to the program unit. This second parameter is also called the control field area for this reason.
kcdad.h	Data structure for the DADM call: You should place this data structure in the KDCS message area during a DADM RQ KDCS call.
kcdf.h	KDCS screen functions: Using these symbolic names, you can influence the screen output by placing the name of the desired function in the KCDF field of the KDCS parameter area. kcdf.h is included by kcmac.h.
kcinf.h	Data structure for the INFO call: You should place this data structure in the KDCS message area during a INFO DT/SI/PC KDCS call.
kcini.h	Defines a second parameter area for the INIT call (only required for INIT PU): openUTM returns the information queried with the INIT PU call in this parameter area.
kcinp.h	Data structure for the INPUT exit: This data structure contains the input and output parameters of the INPUT exit.
kcmac.h	KDCS macro interface for C/C++: This file contains all macros in the C/C++ macro interface as well as the include statements for the kcapro.h, kcca.h, kcdf.h and kcpa.h header files.
kcmsg.h	Data structure for the UTM messages: You will need this data structure if you handle UTM messages in an MSGTAC routine or when you want to evaluate the SYSLOG file using your own program.
kcpa.h	Data structure for the KDCS parameter area: This area contains the parameters of a KDCS call. kcpa.h is included by kcmac.h.
kcpad.h	Data structure for the PADM call: You should place this data structure in the KDCS message area during a PADM AI/PI KDCS call.
kcsgst.h	Data structure for the SIGN call: You should place this data structure over the message area when issuing the KDCS call SIGN ST with KCLA > 0.

Insert the data structures you will use with #include before the call to the program unit. You must explicitly declare the corresponding areas (communication area, KDCS parameter area,...) in the program unit.

Example 3

/* insert constants and data structures */
#include <kcmac.h>                        /* UTM data structures        */
#include <kcinf.h>
   struct ca_area {...};
   struct work
    { union kc_paa param;  
      struct msg_area
       { struct kc_dttm   info_time;      /* area for INFO DT       */
         struct kc_sysinf info_sys;       /* area for INFO SI       */
         char text[200];
       } msg_a;
    };
void cprog (struct ca_area *ca, struct work *spab)