reclaim Method (Format 1)

Description

Reserves the release processing for all the elements of the parameter areas.

When the parameter areas is other than null, execute the same processing that is executed when ExplicitMemory.reclaim(ExplicitMemory area) is invoked assuming the elements as the parameters, for all the elements of the parameter areas. The order of the elements, for which the processing is performed, is not defined. If an exception occurs during the processing for any element, that exception will be thrown. The processing is not executed for the elements that are not processed until the exception is thrown.

Format

public static void reclaim(ExplicitMemory... areas);

Parameters

areas:
This parameter specifies the array containing the Explicit memory block for which the release processing is to be reserved in the elements.

Exceptions

NullPointerException:
The parameter areas is null.
InaccessibleMemoryAreaException:
This functionality is not supported.

Return value

None

Caution

This method only reserves the release processing, and does not actually perform the release processing.

When the option HitachiExplicitMemoryAutoReclaim is ON (-XX:+HitachiExplicitMemoryAutoReclaim is specified), the Explicit memory block after the automatic release will execute the same operation as is executed by the Explicit memory block that is generated by the explicit memory management automatic deployment settings file. If you do not want this operation to be performed, set the option HitachiExplicitMemoryAutoReclaim to OFF (-XX:+HitachiExplicitMemoryAutoReclaim is not specified).