Comments on the description of the KDCS calls

This section describes all the KDCS calls in alphabetical order. This makes it easier for you to look them up.

Every call description consists of 4 parts:

• First, the functions of the call are described.

• Then there is a schematic diagram of the call with all necessary entries. The fields to which you have to assign a value before the call are grayed:

  gray	you must assign a value to this field before the call

  The corresponding C/C++ macros are also listed for each call. For a detailed description of these macros refer to section "C/C++ macro interface".

• This diagram is followed by the description of the statements in the KDCS parameter area and in the 2nd parameter, as well as the return information from openUTM.

• Finally the particularities of the call are explained.

If "—" is entered in a table, then the entry is irrelevant for the function concerned.

The field names of the KDCS interface for COBOL and C/C++ are mostly identical and differ only in the rules for lower case/upper case specification. In cases where further differences exist, the field name for C/C++ is printed after the COBOL field name (separated by a slash), e.g. "KCTAG/kcday".

The return code 79Z is a general error code which indicates that the value in the field KCOP=operation code has an invalid value. It cannot therefore be assigned to any operation code.