WSInvokeDL

CacheStub

Caches generated stubs. This value must be set to true if either or both of the following properties are enabled, ReuseHttpClient, MaintainSession.

Examples of usage:

  callProps.CacheStub=true;

  callProps.ReuseHttpClient = true;

CharSet

Sets the encoding other than UTF-8.

Chunked

Divides the packets into small chunks if the server supports the feature. The default property is true.

Tip: If you receive the following error message when running the WSInvokeDL function then set this property to false.

Transport error: 11 Error: Length Required in policy

ConnectionManagerTimeout

Sets how long (in milliseconds) a client should wait for a free connection before timing out. The default is 30000 milliseconds.

Example usage:

  callProps.ConnectionManagerTimeout=30000;

Starting with 7.1.0.30, the ConnectionManagerTimeout property has been deprecated and you should use WSTimeout instead.

CustomHeaders

Adds custom header values other than the headings that are already supported in the documentation.

DecryptPassword

Enables the decryption of an encrypted password in a policy.

EnableWSS

Enables Web Service Security. If you specify EnableWSS, you must also specify the following properties:

• WSSRepository, which specifies the path location of WSS Repository.
• WSSConfigFile, which specifies configuration file for EnableWSS.
• WSSPolicyFile, which specifies an optional WS-Policy file.

Example:

callProps.EnableWSS = true;
callProps.WSSRepository= "/opt/IBM/tivoli/impact/dsa/wsdsa/wss";
callProps.WSSConfigFile = "/opt/IBM/tivoli/impact/dsa/wsdsa/wss/conf/Sample03_wss.xml";
callProps.WSSPolicyFile = "/opt/IBM/tivoli/impact/dsa/wsdsa/wss/conf/policy03.xml";

WSInvokeDL(WSService, WSEndPoint, WSMethod, WSParams, callProps);

Tip: See Web services security for more information on how to configure Web Services Security.

GetHeaders

Retrieves the Web Service headers and returns them in the ResponseHeaders variable.

To retrieve the Web Service headers, use the following:

    callProps.GetHeaders = true; 

You can access individual headers with dot or bracket notation. For example, to access the Content-Language header:

    Log(ResponseHeaders);
    ContentLanguage = ResponseHeaders["Content-Language"];
    Log(ContentLanguage);

Sample output:

    Parser log: "Context"=(Content-Language=en-GB, Date=Fri, 24 Feb 2017 16:41:12 GMT, Content-Length=259, Content-Type=text/xml; charset=UTF-8, X-Powered-By=Servlet/3.0)  
    Parser log: en-GB

HandleFault

Is used to manage faults. Fault messages are returned from the web services server to indicate that there is a problem.

HTTP

The default HTTP version is 1.1. You can use this property to set the protocol version to 1.0.

KeepAlive

Can be used to enable the KeepAlive header. If set to true, connections are kept alive for reuse by multiple sequential requests and responses. If set to false, connections are closed after the response is sent. It requires HTTP 1.1.

Example usage:

  callProps.KeepAlive = true;

LogSoapMessages

You can enable logging of outgoing and incoming soap messages, by setting the LogSoapMessages property to true. This property should only be used for debugging purposes and should not be enabled permanently in a production environment.

  callProps = NewObject();
  callProps.LogSoapMessages = "true";
  WSInvokeDLResult = WSInvokeDL(WSService, WSEndPoint, WSMethod, WSParams, callProps);

The messages will be logged to $IMPACT_HOME/wlp/usr/servers/<server>/logs/messages.log.

MaintainSession

Sets the session management to enabled status. When session management is enabled, the system maintains the session-related objects across the different requests. The parameter must be set to true or false.

MaxConnectionsPerHost

Sets the maximum number of parallel connections to a host. This value can be increased if the web service client is experiencing timeouts while waiting for a free connection. This number cannot exceed the value of MaxTotalConnections.

Example usage:

    callProps.MaxConnectionsPerHost=10;

MaxTotalConnections

The total number of connections for the web service client across all hosts.

Example usage:

    callProps.MaxTotalConnections=20;

Password

Specifies the password for basic authentication.

PreemptiveAuth

Enables Preemptive Authentication.

ReuseHttpClient

Enables the underlying infrastructure to reuse the HTTP client if one is available. The ReuseHttpClient is useful if the client is using HTTPS to communicate with the server. The parameter must be set to true or false.

SocketTimeout

Specifies how long the client should wait between data packets. If no data is received before the SocketTimeout is reached, the connection will be considered inactive. The default is 60000 milliseconds.

Example usage:

    callProps.SocketTimeout=9000; // Use SocketTimeout instead

Timeout

This property is used in a blocking scenario. The client system times out after the specified amount of time.

You can optionally set a global web Service DSA call timeout property called impact.server.dsainvoke.timeout. The property must be added to the Netcool®/Impact server property file, <servername>_server.props. It is best to use the timeout property on a per policy basis as specified in callProps.Timeout.

The value is set in milliseconds, for example, impact.server.dsainvoke.timeout=30000 (30 seconds).

When you set the properties in any of the .props files, restart theNetcool/Impact server to implement the changes.

If the impact.server.dsainvoke.timeout property is set, all WSInvokeDL calls use the same timeout setting.

TrustCertificate

Allows the WSInvokeDL function to connect to an SSL endpoint without having to import the chain into the trust store. The endpoint's SSL certificate must still be valid and not expired:

callProps.TrustCertificate=true;

Username

Specifies the user name for basic authentication.

WSTimeout

Specifies how long the client should wait when establishing a connection with the remote host. The default is 60000 milliseconds.

Example usage:

    callProps.WSTimeout=60000;

XMLFactory

When set to true, the function will use an internal XML library to generate the SOAP XML payload. This may be useful in resolving compatibility issues with the default XML library.

Example usage:

  callProps.XMLFactory=true;

callProps.Username="username";
callProps.Password="password";

ServiceName = "StockQuote";
EndPointURL = "http://www.webservicex.net/stockquote.asmx";
MethodName = "GetQuote";
ParameterArray = { "IBM" };
callProps = NewObject();

Results = WSInvokeDL(WSService, WSEndPoint, WSMethod, WSParams, callProps);

ServiceName = "StockQuote";
EndPointURL = "http://www.webservicex.net/stockquote.asmx";
MethodName = "GetQuote";
ParameterArray = [ "IBM" ];

Results = WSInvokeDL(WSService, WSEndPoint, WSMethod, WSParams, [callProps])

callProps=NewObject();
callProps.Password="<Web Serice encrypted using nci_crypt>";
callProps.DecryptPassword=true;  
//default is false and must be plain text password.

You can also use the CustomHeaders parameter to add custom http header values other than the headings that are already supported in the documentation.

Headers = NewObject();
Headers.HeaderName1='HeaderValue1';
Headers.HeaderName2='HeaderValue2';
callProps.CustomHeaders=Headers;

Use the HandleFault parameter to handle fault messages.

callProps=NewObject();
callProps.HandleFault=true; 

If the value is true, the return is similar to the following example.

<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<Fault>
	<faultstring> some message here 
	</faultstring>
</Fault>

To turn off the formatting and return the message in plain text add the following parameter anywhere in <serverName>_server.props:

impact.wsinvoke.formatfaultmessage=false

The changes are implemented dynamically without restarting the server.