XML ENCODE()

Purpose

Encode an object as a character string containing XML for use with the messaging functions to pass objects between processes

Syntax

XML_ENCODE(<object> [, <expC1>, <expC2>])

See Also

Messaging Functions, MQCLOSE(), MQCREATE(), MQCURMSGS(), MQOPEN(), MQSEND(), MQRECEIVE(), MQUNLINK(), XML_DECODE(), XML_GATHER(), XML_SCATTER()

Description

The XML_ENCODE() function is used to encode an object and return a character string containing XML. The character string returned can be used with the messaging functions to pass objects between processes. The <object> is the object to be encoded. The optional character expression <expC1> is the XML root tag name. The optional character expression <expC2> is the XML row tag name.

The XML_DECODE() function is used to return the passed XML character string decoded back into an object.

Example

// Open up the queue for read/write access
mqdes=mqcreate("/myqueue2", 2)
if (mqdes < 0)
    messagebox(strerror()+",errno="+alltrim(str(error())))
    return
endif
// send a message to the queue
rc = mqsend(mqdes, xml_encode(tran_obj))
if (rc < 0)
    messagebox(strerror()+",errno="+alltrim(str(error())))
    return
endif
mqclose(mqdes)

Products

Recital, Recital Server