DATA/DISCARD

Description

This command requests the Web User Interface server to release all the resources for the result set associated with the specified stub. Although the server sends a response to the client application (that is, it does not make the request wait), it does not immediately discard the resources used by result set. The result set is marked as discarded and can no longer be accessed by the client. Instead of using a DATA/DISCARD and DATA/GET sequence for a new query, consider using a DATA/GET request that specifies an old stub that is no longer required.

The delay in discarding a result set means that the number of windows shown in the user sessions view (see User sessions panel) can be higher than the number of windows active.

Data: The DATA/DISCARD command does not return any data records after the response header fields.

Options

STUB=value

Specifies the identifier of the result set that you want to discard.

STATUS values

BADCOMMAND

The command passed to the data interface by the Web User Interface is not recognized.

CMASGONE

The Web User Interface has lost its connection with the CMAS. As a result, the client application's user session is terminated.

BADSTUB

The stub value is not valid for the request. This could be for one of the following reasons:

• You have have specified a stub value that does not belong to the user session on which you have issued the command.
• The stub value is out of sequence.

BUSYSTUB

The Web User Interface server is still processing a previous request for this stub.