Ansicht
Dokumentation

OIB_QCI_CALL_EXTERNAL_FUNCTION - Interface for ext. C-code (call system /RFC), ABAP/4 programs:(API/AGA..)

BAL_S_LOG - Application Log: Log header data   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Functionality

This function module is the central function module that connects the ERP part of the Quantity Conversion Interface (QCI) with external programs (e.g. API c-code executables or AGA c-code executables) or customer specific ABAP function modules. Either a remote function call or a call system is supported for the external programs. For AGA c-code executables, only call system is supported with the SAP standard delivery. Support of the remote function call for this c-code executable requires that the SAP standard RFC is extended for command lines with more than 254 characters.

Example

Notes

All customizing settings for this function module in connection with the QCI are made in table OIB04.

Customizing path:

Industry Solution Oil & Gas (Downstream) -> HPM (Hydrocarbon Product Management) -> Petroleum Measurement Standards -> Quantity Conversion Interface (QCI) Configuration -> Define conversion group and external function module settings : select a conversion group and use the link: External function calls and sequence.

Here, you define the sequence of external programs to be executed (FM seq.), the function name (FM name, either a function module name or the name of the external executable, astm (.exe) or agasap (.exe). If an external c-code executable is called, you also have to define the name of the subroutine (FM subrt.) .

The function module type ( FM Type) defines the type of routines that are used to
carry out oil quantity conversion calculations. The calculations may be made using ABAP/4 Routines or external programs. The values which are possible are:

1 = ABAP/4 Function Module

2 = Customer-Function (ABAP/4)

3 = Call system (call a external programm at OS level)

4 = Remote Function Call (RFC)
This type calls the external program, using the RFC
destination "SERVER_EXEC".
CALL FUNCTION 'RFC_REMOTE_PIPE' DESTINATION 'SERVER_EXEC' ...
(See also SM59 -> TCP/IP connections -> SERVER_EXEC.)

5 = ABAP/4 Function Module

6 = Customer-Function (ABAP/4)

Supported combinations of the routines:
Type 1 and 2 support a one time call only. Meaning,
only one function module call per conversion group is possible if you use
function module Type 1 or 2.

Function module type 3, 4, 5 and 6 can be used with each other in any sequence in a
conversion group customizing setting.

FM IMPORT and FM EXPORT: Here you enter the name of the ERP DDIC structures which define the sequence of export and import parameters (only required for mapping to and from any external executable) of all parameters.

Further information

The conversion groups delivered by SAP contain working examples for several different possible settings of table OIB04. Check out the conversion groups 534B, ASPD, AGAD, 234E to understand the different degrees of flexibility of this function.

Parameters

ET_RETURNTAB
EXP_WA
IMP_WA
IT_PARAMTAB

Exceptions

CALCULATION_FAILURE
CONV_EXIT
EXP_PARAMETER
IMP_PARAMETER
INCONSISTENT_CUSTOMIZING
INCONSISTENT_DATA
NOT_CALCULATED
NT_DDIC
OUT_RANGE

Function Group

OIB_QCI

General Data in Customer Master   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Length: 3506 Date: 20240523 Time: 135323     sap01-206 ( 66 ms )