xpxTerminateMapping

SYNTAX:
FUNCTION xpxTerminateMapping  (terminatingCode                 : INTEGER;
                               format                          : STRING;
                               value1, value2, value3, value4  : GENERIC;
                               value5, value6, value7, value8  : GENERIC;
                               value9, value10 value11,value12 : GENERIC;
                               value13,value14,value15,value16 : GENERIC;
                               value17,value18,value19,value20 : GENERIC;
                               value21,value22,value23,value24 : GENERIC;
                               value25                         : GENERIC)
                               status                          : INTEGER;
 
The xpxTerminateMapping function is used to terminate any EDMexpressVM^ process. The function can optionally output a formatted message to the EDMmodelConverter^ output file. The xpxTerminateMapping function can be called with one to N number of arguments. The max. number of arguments N is defined when an EXPRESS Data Manager^ version is generated. The present value of N is 27. If the first parameter is of type INTEGER, then it is the terminatingCode. If the first parameter is of type STRING, then it is the format parameter. The arguments should be exactly like the arguments in printf function in the C language.
The argument <terminatingCode> is optional, and is a status code to be interpreted by the application (edmiConvertModelsBN, edmiConvertModelsWithParametersBN) which invoked the mapping.
Related function: xpxTerminate
Example:
MAP example_of_using_xpxTerminateMapping FOR t:target::anENTITY;
FROM (s:source::aSourceEntity)
WHEN (TRUE);
 BEGIN_MAP
 .........
  IF ( ... ) THEN
   xpxTerminateMapping(?\nFatal error: %ld during mapping.
            \nMapping terminated!!?, fatalError);
  END_IF;
 ......
 END_MAP