|
VADELIA |
|
WADELIA |
EADELIA |
(I/B) (C) |
(I/B) (C) |
(B) (C) |
Context for use
SOAP Web Service consumption.
Section for use
All
Syntax
WS_FREE_RESULT WebServiceId Operation ReqId
Operation |
→ |
OperationId | None |
ReqId |
→ |
*ID(numId) | None |
numId |
→ |
VarNumId | CstNum |
Description
This instruction releases the resources allocated during the Web service call.
If only the name of the Web service is specified, then all resources associated with the service are released.
Note: This instruction must be used consistently when the service is no longer used.
If a Web service name and a request ID are specified, then the resources associated with this request are released.
If a Web service name and an operation name are specified, then the resources associated with this operation and with all requests related to this operation are released.
Note: This instruction must be used if, and only if, several operations of the same service are used.
If a Web service name, an operation name and a request ID are specified, then the resources associated with this operation are released on the condition that the operation is not associated to a request other than the one specified. If the identified request is effectively associated with the specified operation, then its resources are also released.
Notes:
- OperationdId is case-sensitive.
- For an 'RPC/Encoded' SOAP style Web service called in "parameter" mode, the *ID keyword is not supported and OperationId must systematically be specified.
It is possible to check that the resources have been released by testing the *RETURN_CODE reserved word.
If this reserved word returns a value other than *NORMAL, the *RETURN_MSG provides a description of the error.
Example
/* Releases all the resources associated with the GLOBALWEATHER Web service
WS_FREE_RESULT GLOBALWEATHER
/* Releases the resources associated with the request 2 of the GLOBALWEATHER Web service
WS_FREE_RESULT GLOBALWEATHER *ID(2)
/*Releases the resources associated with the GetWeather operation of the GLOBALWEATHER Web service and the resources associated to the requests related to the GetWeather operation.
WS_FREE_RESULT GLOBALWEATHER GetWeather
/*Releases the resources associated with the GetWeather operation of the GLOBALWEATHER Web service and the resources associated to the request 2 but only if it is effectively related to the GetWeather operation.
WS_FREE_RESULT GLOBALWEATHER GetWeather *ID(2)