Section 3c - C Functions

ATMI C Function Reference

tpfml32toxml(3c)

Name

tpfml32toxml()—Converts FML32 buffers to XML data

Synopsis

#include <fml32.h>
int tpfml32toxml (FBFR32 *fml32bufp, char *vfile, char *rtag, char **xmlbufp, long flags)

Description

This function is used to convert FML32 buffers to XML data. It supports the following valid arguments:

fml32bufp

This argument is a pointer to an input FML32 typed buffer.

vfile

This argument is not used for FML32 to XML conversion at this time. It is reserved for the fully qualified path name of an XML Schema file used to validate XML output when this capability is supported by Xerces.

rtag

The argument is a pointer to the input root element name for the output XML document.When a root element name is specified during conversion, it is identified and saved for use as an XML root tag with an optional Type attribute added to the root element name. If the input root name is not specified, then the default output XML root tag <FML32> is used.

xmlbufp

This argument is a pointer to an output XML typed buffer in a pre-defined format for describing FML32 fielded buffers.

flag

This argument is not used for FML32 to XML conversion at this time and should be set to 0.

Return Values

Upon success, tpfml32toxml() returns 0. This function returns -1 on error and sets tperrno to indicate the error condition.

Errors

Upon failure, tpfml32toxml() sets tperrno to one of the following values:

[TPEINVAL]

Either fml32bufp or xmlbufp is not a valid typed buffer.

[TPESYSTEM]

A Tuxedo system error has occurred. The exact nature of the error is written to userlog(3). This will also indicate when a conversion to XML was unable to be done. In that instance error detail info will be added to the userlog.

[TPEOS]

An operating system error has occurred. A numeric value representing the system call that failed is available in Uunixerr.