INFO CK call

With this function the INFO call checks whether the specifications for an MPUT, FPUT or PEND call in KCRN are permitted. openUTM transfers the KDCS return code expected for the checked call to KCRINFCC. INFO CK checks the following calls:

• MPUT NT/NE

• FPUT NT/NE

• PEND PA/PR/KP/SP/RE/FC.

This function enables you, for example, to check prior to a PEND RE call whether the intended follow-up TAC is permitted for this call. This may, for example, prevent the service from aborting.        

Setting the parameters
Field name in KDCS parameter area	Contents
KCOP	"INFO"
KCOM	"CK"
Message area
	KDCS parameter area of the call to be checked

KDCS call
1st parameter	2nd parameter
KDCS parameter area	Message area

C/C++ macro calls
Macro names	Parameter
KDCS_INFOCK	(nb)

openUTM return information
Field name in the KB return area	Contents
KCRINFCC	KCRCCC return code of the checked call
KCRCCC	Return code
KCRCDC	Internal return code

For the INFO call you make the following entries in the KDCS parameter area to check the KDCS parameter area for a UTM call:

KCOP

In the KCOP field, enter the INFO operation code.

KCOM

In the KCOM field, enter the desired function of the call: CK to check the KDCS parameter area for an MPUT-, FPUT-, or PEND call.

Message area

You also have to specify the KDCS parameter area to be checked according to the rules valid for the respective call (MPUT, FPUT, PEND).

You specify the following for the KDCS call:

1st parameter

The address of the KDCS parameter area.

2nd parameter

The address of the area containing the KDCS parameter area of the call to be checked.

Macro names

The use of C/C++ macro calls is described in detail in the section "C/C++ macrointerface".

openUTM returns:

KCRINFCC

in the KCRINFCC field, the return code expected in KCRCCC of the checked call. openUTM enters this error code only if the INFO call runs according to plan (the return code for the INFO call has the value 000).
KCRINFCC has the value 78Z if the specified function form of the call to be checked (KCOP and KCOM entries in the second parameter area) is not supported by the INFO call.

KCRCCC

in the KCRCCC field, the KDCS return code.

KCRCDC

in the KCRCDC field, the internal return code of the checked call (see the openUTM manual ”Messages, Debugging and Diagnostics”).

KDCS return codes in the KCRCCC field for the INFO CK call

The following codes can be analyzed in the program:

000	The call specified in the 2nd parameter was checked.
40Z	Generation error or system error (see KCRCDC).
42Z	KCOM of the INFO call invalid.
47Z	Address of 2nd parameter omitted or invalid.

An additional error code can be found in the dump:

71Z	INIT not yet issued in this program unit.

Features of the call INFO CK

If KCCARD was specified, the INFO CK call in MPUT checks whether the terminal for which the message is destined was generated with an ID card reader or whether the USER is already signed on with an ID card.

On BS2000 systems, this check is also performed if a corresponding edit profile was specified.