xpxConvertModel

 
SYNTAX:
 
xpxConvertModel (sourceModelRepositoryName , sourceModelName     : STRING;
                 schemaMapName, targetModelRepositoryName        : STRING; 
                 targetModelName, declarationsToLog              : STRING;   
                 sourceLinesToLog, sourceInstancesToLog, logFile : STRING;
                 maxLogFileSize                                  : INTEGER;                  userOutputFile                                  : STRING;
                 options                                         : INTEGER)
                 status                                          : INTEGER;
 
The xpxConvertModel defines a new invocation of the EDMmodelConverter^. Please note that the invocation is queued, and that the actual processing does not start until the currently active conversion process has finished. Several EDMmodelConverter^ invocations can be queued. The elements in the queue will be processed in the same order as the elements are put into the queue.
The two arguments sourceModelRepositoryName and sourceModelName defines the Source Model to be converted. The argument schemaMapName defines the name of an EDMexpressX^ mapping schema that must exist as an EXPRESS-X dictionary model in the EXPRESS Data Manager^ database when the actual EDMmodelConverter^ invocation is started. The two arguments targetModelRepositoryName and targetModelName defines the name and repository of the Target Model.
The argument declarationsToLog can be used to define which _EDMexpressX^_ declarations in the actual EDMexpressX^ mapping schema that should be logged (traced) during execution. The declarations to log can be specified by their names or by the line numbers in the source EDMexpressX^ schema where they start. When more than one declaration is specified in the declarationsToLog argument, then the specifications should be separated by comma. When the declarationsToLog argument is an empty string, or is indeterminate , no EDMexpressX^ declarations will be logged.
The argument sourceLinesToLog can be used to specify one or more parts of the actual EDMexpressX^ mapping schema that should be logged (traced) at run time The actual parts to log are specified by line numbers in the source EDMexpressX^ schema. An interval is specified by the line number of the first line, followed by the character hyphen , followed by the line number of the last line in the interval. When more than one part is specified, then each specification should be separated by a comma. When the sourceLinesToLog argument an empty string or as indeterminate ,when no such logging should be performed.
The argument sourceInstancesToLog can be used to specify that the handling of one or more instances in the Source Model should be logged (traced) during the conversion process. The actual instances to log are specified by their instanceIds in the EXPRESS Data Manager{_}^_ database. An interval is specified by the instanceId of the first instance in the interval, followed by the character hyphen followed by the instanceId of the last instance in the interval. When more than one interval is specified, then each interval specification should be separated by a comma. The sourceInstancesToLog argument can be specified as an empty string or as indeterminate ,when no such logging should be performed.
The argument logFile specifies the name of the log file to be used during the actual invocation of the EDMmodelConverter^. An empty string or the value indeterminate for the logFile argument specifies that no log file will be used during the current EDMmodelConverter^ invocation.
The argument maxLogFileSize is used to specify the maximum size in bytes of the specified log file before the logging to the file is terminated or rewounded, dependent of the enabled options in the options argument.
The argument userOutputFile is used to specify the name of a file used for all output from the xpxPrintf and xpxOutputValue functions. When this argument is empty or specified as indeterminate then the output will be on the EDMmodelConverter^ main output device.
The argument options specifies the EDMmodelConverter^ options that should be used during the current invocation. The options argument should be specified as a zero or as a sum of one or more integer constants.
The constants are equivalent to the options used in the EDMinterface^ function edmiConvertModelBN except for that they are prefixed with XPX
The xpxConvertModel function is equivalent to the EDMinterface^ function edmiConvertModelBN
Related functions: xpxConvertModels, xpxConvertModelsWithParameters