Syntax

 

int Xtm(               char *xtmfile,

                         char *xmlfile,

                         char * msgBuffer,

                         int szMsgBuffer)

int XtmUP(           char * user,

                         char * password,

                         char * xtmfile,

                         char * xmlfile,

                         char * msgBuffer,

                         int szMsgBuffer)

int XtmH(             HDBC hdbc,

                         char * xtmfile,

                         char * xmlfile,

                         char * msgBuffer,

                         int szMsgBuffer)

All three functions will process an XTM, retrieve data from a source XML file and update the database. All three functions need to specify the XTM and source XML file names in the filename arguments. The function XtmUP needs to specify a user name and password for database connection. The function XtmH needs to specify a database connection.

Arguments ( for Xtm )

Argument

Input/Output

Description

XtmFileName

Input

XTM filename. It must be a valid file path.

XmlFileName

Input

Source XML filename (cannot be null).

msgBuffer

Output

Pointer to a buffer for any error message. The output result will be null terminated.

szMsgBuffer

Input

Size of msgBuffer.

Arguments ( for XtmUP )

Argument

Input/Output

Description

user

Input

User name: used to establish a database connection.

password

Input

Password: used to establish a database connection.

XtmFileName

Input

XTM filename. It must be a valid file path. 

XmlFileName

Input

Source XML filename (cannot be null).

msgBuffer

Output

Pointer to a buffer for any error message. The output result will be null terminated.

szMsgBuffer

Input

Size of msgBuffer.

Arguments ( for XtmH )

Argument

Input/Output

Description

hdbc

Input

Database connection handle, cannot be null.

XtmFileName

Input

XTM filename: must be a valid file path. 

XmlFileName

Input

Source XML filename, cannot be null.

msgBuffer

Output

Pointer to a buffer for any error message. The output result will be null terminated.

szMsgBuffer

Input

Size of msgBuffer.

Returns

Description

SUCCESS

Engine successfully processed source XML file with XTM specification.

ERR_XTM_PROCESS

Possible reasons for XTM process errors include:

XSTL process error – XTM or source XML file is not valid XML, or the XTM is not a valid XSL file.

XTM syntax error.

SQL Error

The SQL command produced an error.