Inventory request processing
Overview
The NFM-P processes find requests synchronously. A findToFile request runs synchronously by default, but you can use the <synchronous> Boolean element to specify whether a findToFile request runs synchronously or asynchronously.
Synchronous requests
When the NFM-P receives multiple synchronous find or findToFile requests, up to five are processed concurrently. Subsequent synchronous requests are rejected with the following exception, which is sent in the HTTP response:
javax.xml.stream.XMLStreamException: The Inventory connections reached its maximum please retry later
Asynchronous findToFile requests
When the NFM-P receives multiple asynchronous findToFile requests, up to five are processed concurrently, and up to an additional ten requests are queued to be processed. If the NFM-P is currently servicing 15 asynchronous requests, further incoming requests are immediately rejected with the following exception:
Figure 13-8: Too many requests exception
<findToFileException xmlns="xmlapi_1.0"> |
<description>Cannot perform findToFile command, too many queued requests</description> |
</findToFileException> |
You can configure a timeout value for the OSS requests associated with an NFM-P user or user group. When a request times out, the NFM-P sends an exception in a fileAvailableEvent JMS notification. The notification includes a status element that contains FAILURE, as shown in the following figure:
Figure 13-9: OSS request timeout notification
<SOAP:Body> |
<jms xmlns="xmlapi_1.0"> |
<fileAvailableEvent> |
<requestID>XML_API_client@n</requestID> |
<fileName>asynchronous_request.xml</fileName> |
<status>FAILURE</status> |
<errorMessage>javax.xml.stream.XMLStreamException: The request timed out for waiting for a worker. XML API request id [:0:1] User Name [ossuser_10] File Name [asynchronous_request.xml]. Please retry later.</errorMessage> |
</fileAvailableEvent> |
</jms> |
</SOAP:Body> |
Mix of find and findToFile requests
When the NFM-P receives a combination of synchronous find, and synchronous or asynchronous findToFile requests, up to five requests are processed concurrently; subsequent synchronous or asynchronous requests are rejected with the following exception, which is sent in the HTTP response:
javax.xml.stream.XMLStreamException: The Inventory connections reached its maximum please retry later
© 2023 Nokia. Nokia Confidential Information
Use subject to agreed restrictions on disclosure and use.