Data Interfaces

Initializing Connections (INIT)
ABAP/4 C
... ...
COMMUNICATION INIT INIT
DESTINATION dest dest
ID ID convid convid
[ [ RETURNCODE rc rc ] ]
... ...
© SAP AG
...
CMINIT (
convid,
dest,
&rc );
...
The program setting up the CPI-C connection must first execute an INIT call. This uses a symbolic
address to access the side information file (which contains the connection and communication
parameters).
symbolic_dest: Symbolic name (entry in the side information table)
conversation_id: This value is returned by the routine and must be specified in all subsequent CPI-
C calls
for this connection.
return_code: Error code: (0 (CM_OK) --> routine executed without error).
The variables are defined in the include RSCPICDF for ABAP/4, and in the file "cpic.h" for C.
ABAP/4: DEST C 8 C: dest PCPIC_CHAR
CONVID C 8 convid PCONVERSATION_ID
RC X 2 rc CM_RETCODE
(Examples: ABAP/4: --> DATA: DEST(8) TYPE C.
C: --> PCPIC_CHAR dest = (PCPIC_CHAR)0;)
For C data types, you should note the following:
& --> is an address operator and returns a pointer to an object
* --> is a reference operator and returns the address of an object
Legend: Italics --> denote a variable
Underlined characters --> input variable which must be specified during the call
[ ... ] --> optional specification