Obtaining one or more generation data sets


To retrieve a specific generation dataset of a generation data group from an IDataSetCommandProvider:

IDataSetCommandProvider commandProvider = ...
String generationDataGroupName = ...
int relativeGenerationNumber = ...

// generationDataSet will be null if the generation data
// group does not exist or a generation dataset does not exist for the
// specified relative generation number
IDataSet generationDataSet = commandProvider.findGenerationDataSet(
       generationDataGroupName, relativeGenerationNumber);

To retrieve a specific generation data set of a generation data group from an IGenerationDataGroup:

IGenerationDataGroup generationDataGroup = ...
int relativeGenerationNumber = ...

// generationDataSet will be null if a generation dataset
// does not exist for the specified relative generation number
IDataSet generationDataSet = generationDataGroup
        .findGenerationDataSet(relativeGenerationNumber);

To retrieve a specific generation data set of a generation data group, typed as an ISequentialDataSet, from an IDataSetCommandProvider:

IDataSetCommandProvider commandProvider = ...
String generationDataGroupName = ...
int relativeGenerationNumber = ...

// generationDataSet will be null if the generation data
// group does not exist, or a generation sequential dataset does not
// exist for the specified relative generation number
ISequentialDataSet generationDataSet = commandProvider
        .findGenerationSequentialDataSet(generationDataGroupName,
               relativeGenerationNumber);

To retrieve a specific generation data set of a generation data group, typed as an ISequentialDataSet, from an IGenerationDataGroup:

IGenerationDataGroup generationDataGroup = ...
int relativeGenerationNumber = ...

// generationDataSet will be null if a generation
// sequential dataset does not exist for the specified relative
// generation number
ISequentialDataSet generationDataSet = generationDataGroup
        .findGenerationSequentialDataSet(relativeGenerationNumber);

To retrieve a list of all generation data sets of a generation data group from an IDataSetCommandProvider:

IDataSetCommandProvider commandProvider = ...
String generationDataGroupName = ...

// generationDataSets will be empty if the generation data group does
// not have any generation datasets
List<IDataSet> generationDataSets = commandProvider
        .fetchGenerationDataSets(generationDataGroupName);

To retrieve a list of all generation data sets of a generation data group from an IGenerationDataGroup:

IGenerationDataGroup generationDataGroup = ...

// generationDataSets will be empty if the generation data group does
// not have any generation datasets
List<IDataSet> generationDataSets = generationDataGroup
        .fetchGenerationDataSets();