NonStop SOAP 4.1 User's Manual

Parameters:
element
is an input parameter and is a pointer to the element whose attribute must be found.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return Values:
Pointer to the attribute with the given qname. If an error occurs, it returns NULL and sets the error
code in the environment error structure.
APIs to Invoke the Web Service
NonStop SOAP 4 clients can invoke their respective NonStop SOAP 4 services in synchronous
(blocking) or asynchronous (non-blocking) mode using the following APIs:
• “The axis2_svc_client_send_receive() Function” (page 113)
• “The axis2_svc_client_send_receive_non_blocking() Function” (page 113)
• “The axis2_svc_client_send_robust() Function” (page 114)
• “The axis2_svc_client_fire_and_forget() Function” (page 114)
The axis2_svc_client_send_receive() Function
The axis2_svc_client_send_receive() function sends an XML request and receives the
XML response. This function is used to interact with a service operation whose message exchange
pattern (MEP) is IN-OUT.
Synopsis:
AXIS2_EXTERN axiom_node_t* axis2_svc_client_send_receive
( axis2_svc_client_t * svc_client,
const axutil_env_t * env,
const axiom_node_t * payload
)
Parameters:
svc_client
is a pointer to the service client structure.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
payload
is a pointer to the AXIOM node, which represents the XML payload to be sent. The caller
controls the payload until the service client releases it.
Return Value:
Is a pointer to the OM node representing the XML response.
The axis2_svc_client_send_receive_non_blocking() Function
The axis2_svc_client_send_receive_non_blocking() function sends an XML request
and receives the XML response, but it does not block for the response. This function is used to
interact in the non-blocking mode with a service operation, which has an IN-OUT message exchange
pattern.
Synopsis:
AXIS2_EXTERN void axis2_svc_client_send_receive_non_blocking
( axis2_svc_client_t * svc_client,
NonStop SOAP 4 Client APIs 113