NonStop SOAP 4.1 User's Manual

Return Value:
Pointer to the AXIOM node built from the document. If an error occurs, it returns NULL.
The axiom_document_free()Function
The axiom_document_free()function is used to free the document structure from the memory.
Synopsis:
AXIS2_EXTERN void axiom_document_free
( struct axiom_document_t* document,
const axutil_env_t * env)
Parameters:
document
is an input parameter and is a pointer to the document structure that becomes free from the
memory.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return Value:
Void.
APIs for Logging
The NonStop SOAP 4 service API includes the logging APIs to create and log messages.
Logging APIs enable you to create the log file structure, which includes the location and the name
of the log file.
Creating the log file structure
The axutil_log_create()function is called to create the log file structure.
Synopsis:
AXIS2_EXTERN axutil_log_t * axutil_log_create
(axutil_allocator_t *allocator,
axutil_log_ops_t *ops,
const axis2_char_t *stream_name)
Parameters:
allocator
is an input parameter and is a pointer to the axutil_allocator structure.
ops
is an input parameter and is a pointer to the options structure for logging.
stream_name
is an input parameter and is a pointer to the file name and location where the log must be
created.
Return Values:
Pointer to the newly created log structure. If an error occurs, it returns NULL.
Developing NonStop SOAP 4 Services using Service APIs
This section describes the procedure to develop and deploy a NonStop SOAP 4 service, using the
math service as an example.
Developing NonStop SOAP 4 Services using Service APIs 95