Defining a generation data group

In order to define a generation data group, you first must create the define generation data group parameters using a DefineGenerationDataGroupParametersBuilder. After creating your parameters, you can then define your generation data group using an IDatasetCommandProvider.

To create define generation data group parameters using all defaults:

IDefineGenerationDataGroupParameters parameters = DefineGenerationDataGroupParametersBuilder
        .defaults().build();

To create define generation data group parameters while overriding some parameters:

IDefineGenerationDataGroupParameters parameters = DefineGenerationDataGroupParametersBuilder
        .defaults().setGenerationsLimit(50)
        .setScratchOnEmpty(true, false).build();

// alternatively:

DefineGenerationDataGroupParametersBuilder builder = DefineGenerationDataGroupParametersBuilder
        .defaults();
builder.setGenerationsLimit(50);
builder.setScratchOnEmpty(true, false);
IDefineGenerationDataGroupParameters parameters = builder.build();

To define a generation data group:

IDataSetCommandProvider commandProvider = ...
String generationDataGroupName = ...
IDefineGenerationDataGroupParameters parameters = ...

try {
    commandProvider.defineGenerationDataGroup(generationDataGroupName,
            parameters);
} catch (GenerationDataGroupExistsException e) {
    // the generation data group (or a like-named dataset) already
    // exists
    ...
} catch (DefinitionFailedException e) {
    // the definition failed - most likely because the user does not
    // have the proper authority
    ...
}