COMMUNICATION - cpic_options

Syntax

... [RETURNCODE rc]
    [LENGTH leng]
    [RECEIVED rec]
    [HOLD] ... .

Extras:

1. ... RETURNCODE  rc

2. ... LENGTH leng

3. ... RECEIVED rec

4. ... HOLD

Effect

Additional additions for the statement

COMMUNICATION.

Addition 1

... RETURNCODE rc

Effect

This addition can be specified in all connection steps. The data type i is expected for rc. The meaning of the return values is coded in the include program RSCPICDF. Here, data objects with descriptive names and start values are declared and can be compared with rc. The following table contains a list of possible return values.

rc Data Object in RSCPICDF
0 CM_OK
1 CM_ALLOCATE_FAILURE_NO_RETRY
2 CM_ALLOCATE_FAILURE_RETRY
3 CM_CONVERSATION_TYPE_MISMATCH
6 CM_SECURITY_NOT_VALID
8 CM_SYNC_LVL_NOT_SUPPORTED_PGM
9 CM_TPN_NOT_RECOGNIZED
10 CM_TP_NOT_AVAILABLE_NO_RETRY
11 CM_TP_NOT_AVAILABLE_RETRY
12 CM_DEALLOCATED_ABEND
13 CM_DEALLOCATED_NORMAL
14 CM_PARAMETER_ERROR
15 CM_PRODUCT_SPECIFIC_ERROR
16 CM_PROGRAM_ERROR_NO_TRUNC
18 CM_PROGRAM_ERROR_NO_TRUNC
19 CM_PROGRAM_ERROR_TRUNC
26 CM_RESOURCE_FAILURE_NO_RETRY
27 CM_RESOURCE_FAILURE_RETRY
28 CM_UNSUCCESSFUL

The same return values are also written in the system field sy-subrc.

Addition 2

... LENGTH leng

Effect

This addition can only be specified in the connection steps SEND and RECEIVE. As a result, the data buffer buffer is only sent or received in the length leng. A data object of data type i is expected for the length specification leng.



Addition 3

... RECEIVED rec

Effect

This addition can only be specified in the connection step RECEIVE. The data object rec contains the number of bytes received by the partner program. Only byte-like data objects of length 4 are allowed for rec.



Addition 4

... HOLD

Effect

This addition can only be specified using the connection step RECEIVE. It prevents the internal session being changed during the receiving process to avoid the possible loss of the database cursor. In this case, the current work process waits until the data transfer is complete.