NonStop SOAP User's Manual

NonStop SOAP Features and Functions
NonStop SOAP User’s Manual—520501-012
4-10
Server-Side Cookie File
SOAP_SESSION_TIMEOUT has a default value of 30 minutes. If you specify a value
greater than 432000, the SOAP server uses the value 432000 (that is, 300 days). If
you specify a value less than 0, the SOAP server returns an error.
If a session times out and the client sends a request that specifies the session ID, the
SOAP server sends back a fault response. The server cannot differentiate between a
session that has expired and a session that never existed (a mistaken session ID).
Server-Side Cookie File
The SOAP server saves session information in a key-sequenced Enscribe file called
the server-side cookie file. The file contains context information for all sessions known
to the SOAP server. The session ID (SessionID) is the primary key for this file.
The default name of the server side cookie file is $SYSTEM.NSSOAP.SSCOOKIE, but
you can specify a different filename by using the environment variable
SOAP_COOKIE_FILE.
You specify SOAP_COOKIE_FILE in the NonStop SOAP configuration file described in
NonStop SOAP Configuration File on page 4-60.
The filename must follow Guardian file naming conventions. The required format is
'<$ volume >.< subvolume >.< filename >'
The name must be fully qualified.
Note. TMF has an autoabort function that causes a transaction to be aborted if it exceeds an
amount of time called the autoabort threshold. If TMF aborts the transaction, the SOAP server
also aborts the transaction and ends the session, even if the session timeout has not elapsed.
Example 4-11. Fault for Session Timeout
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client.Process</faultcode>
<faultstring>Error processing the header of XML
document</faultstring>
<detail>
<detailCode>-1</detailCode>
<detailString ts= timestamp >SessionID <SessionID> was not found in the
server, or SOAP session identified by the SessionID has expired.
Please check the SessionID or start a new session if
necessary.</detailString>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>