Capability Requests and Responses

When your usage-capture code communicates with FlexNet Operations, the communications involve capability requests and capability responses. A capability request is generated by the client (either a client reporting usage or requesting features that it will acquire). The request data contains some combination of a host identifier, one or more desired features, and other optional data to pass to FlexNet Operations.

The license server instance then processes the request, reading the various identifiers, desired features, and custom data. If FlexNet Operations determines that the client requires a response, it generates a capability response. The response data contains current license rights available for the client. The capability response is then conveyed back to the client, which processes the response, after which the features in the response can be queried for the sake of detecting if a quota has been exceeded or for feature clipping (programmatically restricting access to features based on the capability response).

Your usage-capture code specifies one or more desired features, which represent features whose usage is being reported or features desired for the sake of feature clipping, in the capability request.

Your code also specifies an operation in the capability request, which indicates whether it is simply reporting feature usage, or whether a response is expected. The “report” operation is used in uncapped-usage scenarios, when no response is needed; and the “request” operation is used in capped-usage and feature-clipping scenarios, where a response is needed. The request operation can also be used in untrusted environments to report uncapped usage to force a confirmation response from the server, ensuring that the usage has been reported. (There is also an “undo” operation, which enables recent information to be undone, in case of error or canceled usage.)