The error categories are as follows:
Code | Category | Response |
000 | No error | Operation carried out without errors |
01Z - 09Z | Comments | Operation carried out |
10Z - 19Z | Warning or minor errors | Once suitable action has been taken, the program unit run can be continued. The operation was not carried out. |
20Z - 39Z | Special functions | A KDCS special function is signaled. Otherwise as for warnings. |
40Z - 69Z | Errors | The operation was not carried out. In most cases it will be pointless to continue the program run. Communication with the dialog terminal is still possible. |
70Z - 99Z |
Please note the following:
For a detailed explanation of the return codes in KCRCCC see the openUTM manual „Programming Applications with KDCS” under each individual KDCS call.
If more than one error occurs at any one time, the errors from the highest category are displayed. If an operation was not carried out (return code > 09Z) the contents of <parm2> are not modified.
Evaluation of a UTM-DUMP is described in chapter “The UTM dump”.
The following return codes are defined (field name specifications: COBOL name/C name):
Code | Meaning |
000 | The operation was carried out successfully. |
01Z | Length conflict in KCLA/kcla or KCLKBPRG/kclcapa. |
02Z | Length conflict in KCLPAB/kclspa. |
03Z | Name in KCRN/kcrn invalid. |
04Z | Name in KCRN changed. |
05Z | Input formatting not carried out with the format identifier specified in KCMF/kcfn. |
06Z | Time entry changed within message (DPUT call). |
07Z | Length conflict regarding KCLI/kcli. |
08Z | When reading with waiting in the DGET call: There is currently no message. |
09Z *) | For INFO CD: The Kerberos dialog has returned an error or the Kerberos information was returned in truncated form. |
10Z | Message already read completely. |
11Z | When reading without waiting in the DGET call: There is no message. |
12Z | No (more) messages from specified service ID or no service stack with the specified number available. |
14Z | Name in KCRN/kcrn not found. |
16Z | Operation is illegal and was not performed. |
19Z | Function key or special function not generated. |
20Z - 39Z | KDCS special functions (short messages). |
40Z | System cannot perform operation (UTM generation error, system error, deadlock, longterm locks). |
41Z | Operation illegal at this point. |
42Z | Operation modifier invalid. |
43Z | Length entry in KCLM/kclm, KCLI/kcli or KCLA/kcla or KCWTIME/kcwtime invalid. |
44Z | Name in KCRN/kcrn invalid. |
45Z | Format identifier KCMF/kcfn or creation time (DGET) invalid. |
46Z | Name in KCLT/kclt or KCPA/kcpa or KCLANGID/kclangid, KCTERRID/kcterrid, KCCSNAME/kccsname or KCQMODE/kcqmode is invalid. |
47Z | Storage area <parm2> missing or invalid area address or area cannot be read/written in the specified length. |
48Z | Invalid interface version. |
49Z | Unused parameters are not equal to binary zero. |
51Z | Sequence not maintained in DPUT call. |
52Z | Message destination is not permitted in KCRN (DPUT call). |
53Z | Value in KCDPID/kcdpid or KCGTM/kcgtm is invalid (DGET call). |
54Z | Value in KCNORPLY/kcnoreply is invalid (in the case of CTRL PR or PE: Value not equal Y or binary zero). |
55Z | Name in KCPI/kcpi is invalid (APRO call). |
56Z | Value of KCMOD or time entry in KCTAG/kcday,...,KCSEK/kcsec is invalid (DADM, DPUT call). |
57Z | Value in KCPOS/kcpos is invalid (MCOM call). |
58Z | Value in KCOF/kcof (APRO call)is invalid or the value in KCNEG/kcneg is invaliid ( |
70Z | System cannot perform operation (UTM generation error, system error). |
71Z | Operation not permitted at this stage, e.g. because INIT has not yet been issued. |
72Z | Operation modifier invalid. |
73Z | Length entry in KCLM/kclm, KCLA/kcla or KCLI/kcli invalid. |
74Z | Name in KCRN/kcrn invalid. |
75Z | Format ID KCMF/kcfn invalid. |
77Z | Storage area <parm2> missing or invalid area address. |
78Z *) | FORMAT exit reports error (MGET call). |
79Z | Operation code cannot be interpreted. |
80Z | UTM generation error prior to start of program. |
81Z | Destination in PEND conflicts with destination in MPUT. |
82Z | PEND variant conflicts with operand KCOM/kcom or KCRN/kcrn in the MPUT call. |
83Z | MPUT not issued prior to a PEND KP,RE,FI,ER,FR in a dialog program or an MPUT was not issued prior to a PEND KP,RE in an asynchronous program or an MPUT was issued prior to a PGWT PR. |
84Z | PEND missing |
86Z | A message complex was not terminated or no FPUT/DPUT was issued after APRO AM for the addressed job-receiving service. |
87Z | Operation modifier is illegal. |
88Z | Invalid interface version. |
89Z | Unused parameters are not equal to binary zero. |
*) the values appear only on BS2000 systems.